kcode-pi 0.1.0

package/vendor/kingdee-skills/cosmic-unittest/examples/op-plugin-test.md

@@ -0,0 +1,231 @@
+# OpPlugin 操作插件测试完整示例
+
+> 以 `ProcessPlanSaveOp` 为例，展示操作插件的完整测试写法。
+
+```java
+package kd.mmc.sfc.opplugin.processplan;
+
+import kd.bos.dataentity.OperateOption;
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.dataentity.entity.DynamicObjectCollection;
+import kd.bos.entity.operate.result.OperationResult;
+import kd.bos.entity.plugin.args.BeforeOperationArgs;
+import kd.bos.entity.plugin.args.BeginOperationTransactionArgs;
+import kd.bos.exception.KDBizException;
+import kd.bos.form.unittest.DisplayName;
+import kd.bos.org.utils.Consts;
+import kd.bos.servicehelper.BusinessDataServiceHelper;
+import kd.bos.test.ext.annotaions.UnittestCaseInfo;
+import kd.bos.unittest.AbstractJunitNoDependenciesResManagerTest;
+import kd.bos.unittest.mock.DynamicObjectMocker;
+import kd.mmc.sfc.business.OperationHelper;
+import kd.mmc.sfc.business.ProcessPickingHelper;
+import kd.mmc.sfc.business.ProcessPlanHelper;
+import kd.mmc.sfc.common.processplan.ProcessPlanConsts;
+import org.junit.After;
+import org.junit.Assert;
+import org.junit.Before;
+import org.junit.Test;
+import org.mockito.MockedStatic;
+
+import java.util.*;
+
+import static org.mockito.ArgumentMatchers.*;
+import static org.mockito.Mockito.*;
+
+/**
+ * 工序计划保存操作单元测试
+ * @author zhang_san
+ * @date 2025/5/14 10:50
+ */
+public class ProcessPlanSaveOpTest extends AbstractJunitNoDependenciesResManagerTest {
+
+    // ========== 1. 声明 MockedStatic ==========
+    MockedStatic<ProcessPickingHelper> processPickingHelper;
+    private BeginOperationTransactionArgs beginOperationTransactionArgs;
+
+    // ========== 2. @Before ==========
+    @Before
+    public void before() {
+        processPickingHelper = mockStatic(ProcessPickingHelper.class);
+
+        // 构建测试数据
+        DynamicObject[] planS = getBillS();
+
+        // Mock 事务参数
+        beginOperationTransactionArgs = mock(BeginOperationTransactionArgs.class);
+        when(beginOperationTransactionArgs.getDataEntities()).thenReturn(planS);
+        when(beginOperationTransactionArgs.getOperationKey())
+            .thenReturn(ProcessPlanConsts.OPERATION_CONST.SAVE);
+    }
+
+    // ========== 3. @After ==========
+    @After
+    public void after() {
+        processPickingHelper.close();
+    }
+
+    public void reset() {
+        processPickingHelper.reset();
+    }
+
+    // ========== 4. 构建测试单据 ==========
+    private DynamicObject[] getBillS() {
+        Set<DynamicObject> billSet = new HashSet<>();
+        billSet.add(new DynamicObjectMocker()
+            .add(Consts.ID, 2128998950412872704L)
+            .add(ProcessPlanConsts.BILLNO, "GXJH-20231109-00000047")
+            .add(ProcessPlanConsts.ROOTPROCESSPLAN_ID, 0L)
+            .add(ProcessPlanConsts.WORKROWID, 11L)
+            .getObject());
+        billSet.add(new DynamicObjectMocker()
+            .add(Consts.ID, 1814710693405206528L)
+            .add(ProcessPlanConsts.BILLNO, "GXJH-20231109-00000048")
+            .add(ProcessPlanConsts.ROOTPROCESSPLAN_ID, 996L)
+            .add(ProcessPlanConsts.WORKROWID, 22L)
+            .getObject());
+        return billSet.toArray(new DynamicObject[0]);
+    }
+
+    // ========== 5. 测试方法 ==========
+
+    @UnittestCaseInfo(
+        author = "zhang_san <zhang_san@kingdee.com>",
+        title = "Test begin operation transaction",
+        targetClass = "kd.mmc.sfc.opplugin.processplan.ProcessPlanSaveOp",
+        targetMethod = "beginoperationtransaction",
+        lastUpdateTime = "2025-05-14 14:55:40",
+        lastUpdateAuthor = "zhang_san <zhang_san@kingdee.com>",
+        methodSignature = "public void beginOperationTransaction(BeginOperationTransactionArgs e)",
+        testPoints = {"Functionality"},
+        description = "Test begin operation transaction"
+    )
+    @Test
+    @DisplayName("测试校验成功时")
+    public void testBeginOperationTransactionValidationSucceeds() {
+        //step 创建成功的操作结果
+        OperationResult operation = mock(OperationResult.class);
+        when(operation.isSuccess()).thenReturn(true);
+
+        // 使用匿名子类注入 Mock 的 OperationResult
+        ProcessPlanSaveOp saveOp = new ProcessPlanSaveOp() {
+            @Override
+            public OperationResult getOperationResult() {
+                return operation;
+            }
+        };
+        OperateOption option = OperateOption.create();
+        saveOp.setContext(null, null, option);
+
+        //step 执行方法
+        saveOp.beginOperationTransaction(beginOperationTransactionArgs);
+
+        //assert 验证 ProcessPickingHelper.setMftStockPlanNo 被调用
+        processPickingHelper.verify(
+            () -> ProcessPickingHelper.setMftStockPlanNo(any(Map.class)), times(1));
+        reset();
+    }
+
+    @Test
+    @DisplayName("测试校验失败时")
+    public void testBeginOperationTransactionValidationFails() {
+        //step 创建失败的操作结果
+        OperationResult operation = mock(OperationResult.class);
+        when(operation.isSuccess()).thenReturn(false);
+
+        ProcessPlanSaveOp saveOp = new ProcessPlanSaveOp() {
+            @Override
+            public OperationResult getOperationResult() {
+                return operation;
+            }
+        };
+        OperateOption option = OperateOption.create();
+        saveOp.setContext(null, null, option);
+
+        //step 执行方法，期望抛异常
+        Exception exception = Assert.assertThrows(KDBizException.class,
+            () -> saveOp.beginOperationTransaction(beginOperationTransactionArgs));
+
+        //assert 验证异常消息
+        assertTrue(exception.getMessage().contains("保存校验失败。"));
+        reset();
+    }
+
+    // ========== 6. try-with-resources 模式（方法级 Mock）==========
+
+    @Test
+    public void testBeforeExecuteOperationTransaction() {
+        // 使用 try-with-resources 管理仅此方法需要的 Mock
+        try (MockedStatic<OperationHelper> operationHelper = mockStatic(OperationHelper.class);
+             MockedStatic<ProcessPlanHelper> processPlanHelper = mockStatic(ProcessPlanHelper.class);
+             MockedStatic<BusinessDataServiceHelper> businessDataServiceHelper =
+                 mockStatic(BusinessDataServiceHelper.class)) {
+
+            //step 数据构造
+            operationHelper.when(() -> OperationHelper.setFirstOrLastProcess(any()))
+                .thenAnswer(invocation -> null);
+
+            Map<String, Object> validatorResult = new HashMap<>(1);
+            validatorResult.put("code", 200L);
+            validatorResult.put("message", "errormessage");
+            operationHelper.when(() -> OperationHelper.validator(any()))
+                .thenReturn(validatorResult);
+
+            processPlanHelper.when(() -> ProcessPlanHelper.sortEntrySetRowSeq(any()))
+                .thenAnswer(invocation -> null);
+
+            businessDataServiceHelper.when(() ->
+                    BusinessDataServiceHelper.loadFromCache(anyString(), anyString(), any()))
+                .thenReturn(new HashMap<>(0));
+
+            // 构建带分录的复杂单据
+            DynamicObject entry = new DynamicObjectMocker()
+                .add(ProcessPlanConsts.ENTRY.PROCESSSEQUENCE, 1)
+                .add(ProcessPlanConsts.ENTRY.PROCESSNUMBER, 10)
+                .add("processbarcode", null)
+                .add("entryentity_lk", new DynamicObjectMocker()
+                    .add("entryentity_lk_stableid", "12345")
+                    .add("entryentity_lk_sid", "147258")
+                    .add("entryentity_lk_sbillid", "456789").getCollection())
+                .getObject();
+
+            DynamicObjectCollection entries = new DynamicObjectCollection();
+            entries.add(entry);
+
+            DynamicObject bill = new DynamicObjectMocker()
+                .add(ProcessPlanConsts.BILLNO, "GXJH-20251208-00000001")
+                .add(ProcessPlanConsts.ENTRY.ENTRYENTITY_ENTITY, entries)
+                .add(ProcessPlanConsts.ROOTPROCESSPLAN_ID, 1L)
+                .add(ProcessPlanConsts.SPLITLEVEL, 0)
+                .getObject();
+
+            BeforeOperationArgs args = mock(BeforeOperationArgs.class);
+            when(args.getDataEntities()).thenReturn(new DynamicObject[]{bill});
+            when(args.getOperationKey()).thenReturn("save");
+
+            //step 执行方法
+            ProcessPlanSaveOp saveOp = new ProcessPlanSaveOp();
+            saveOp.beforeExecuteOperationTransaction(args);
+
+            //assert 验证条码已生成
+            String barcode = bill.getDynamicObjectCollection(
+                ProcessPlanConsts.ENTRY.ENTRYENTITY_ENTITY)
+                .get(0).getString("processbarcode");
+            assertTrue(barcode != null && !barcode.isEmpty());
+            reset();
+        }
+        // MockedStatic 自动关闭
+    }
+}
+```
+
+## 要点总结
+
+1. **匿名子类注入 OperationResult**：操作插件依赖 `getOperationResult()` 判断成败，
+   通过匿名子类 override 注入 Mock 对象
+2. **setContext**：操作插件需要调用 `setContext(entityType, operateMeta, option)` 初始化上下文
+3. **Mock Args**：`BeginOperationTransactionArgs` 等参数对象用 `mock()` 创建，
+   配置 `getDataEntities()` 和 `getOperationKey()` 返回值
+4. **try-with-resources**：仅在单个测试方法中使用的 Mock 可用此模式自动管理生命周期
+5. **assertThrows**：测试异常场景使用 `Assert.assertThrows(ExceptionClass.class, () -> ...)`
+6. **verify 验证调用**：用 `mockStatic.verify(() -> method(), times(n))` 验证静态方法被调用次数

package/vendor/kingdee-skills/cosmic-unittest/examples/validator-test.md

@@ -0,0 +1,232 @@
+# Validator 校验器测试完整示例
+
+> 以 `OutSendProcessQtyValidator` 为例，展示校验器的完整测试写法。
+
+```java
+package kd.mmc.sfc.opplugin.validator;
+
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.entity.ExtendedDataEntity;
+import kd.bos.entity.validate.ErrorLevel;
+import kd.bos.test.ext.annotaions.UnittestCaseInfo;
+import kd.bos.unittest.AbstractJunitNoDependenciesResManagerTest;
+import kd.bos.unittest.mock.DynamicObjectMocker;
+import kd.mmc.sfc.business.OutSourceSendQtyCheckHelper;
+import kd.mmc.sfc.business.OutsourceSendHelper;
+import kd.mmc.sfc.business.ProcessPlanHelper;
+import kd.mmc.sfc.common.insideaccept.InsideAcceptConst;
+import kd.mmc.sfc.common.outsourcesend.OutsourceSendConsts;
+import kd.mmc.sfc.opplugin.Validator.OutSendProcessQtyValidator;
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+import org.mockito.MockedStatic;
+import org.mockito.Mockito;
+import org.mockito.MockitoAnnotations;
+
+import java.math.BigDecimal;
+import java.util.*;
+
+import static org.mockito.ArgumentMatchers.*;
+import static org.mockito.Mockito.*;
+
+public class OutSendProcessQtyValidatorTest extends AbstractJunitNoDependenciesResManagerTest {
+
+    // ========== 1. Mock 声明 ==========
+    private MockedStatic<OutsourceSendHelper> outsourceSendHelper;
+    private MockedStatic<ProcessPlanHelper> processPlanHelper;
+    private MockedStatic<OutSourceSendQtyCheckHelper> outSourceSendQtyCheckHelper;
+
+    // ========== 2. 错误收集器 ==========
+    private List<Integer> errorIndexs = new ArrayList<>();
+    private final List<String> errorMessages = new ArrayList<>();
+
+    @Before
+    public void before() {
+        MockitoAnnotations.openMocks(this);
+        outsourceSendHelper = Mockito.mockStatic(OutsourceSendHelper.class);
+        processPlanHelper = Mockito.mockStatic(ProcessPlanHelper.class);
+        outSourceSendQtyCheckHelper = Mockito.mockStatic(OutSourceSendQtyCheckHelper.class);
+    }
+
+    @After
+    public void after() {
+        outsourceSendHelper.close();
+        processPlanHelper.close();
+        outSourceSendQtyCheckHelper.close();
+    }
+
+    // ========== 3. 构建校验器（核心：匿名子类重写消息方法）==========
+    private OutSendProcessQtyValidator buildValidator() {
+        return new OutSendProcessQtyValidator() {
+            @Override
+            protected void addMessage(ExtendedDataEntity dataEntity, String content) {
+                errorIndexs.add(dataEntity.getDataEntityIndex());
+                errorMessages.add(content);
+            }
+            @Override
+            protected void addMessage(ExtendedDataEntity dataEntity, String content, ErrorLevel errorLevel) {
+                errorIndexs.add(dataEntity.getDataEntityIndex());
+                errorMessages.add(content);
+            }
+            @Override
+            protected void addErrorMessage(ExtendedDataEntity dataEntity, String content) {
+                errorIndexs.add(dataEntity.getDataEntityIndex());
+                errorMessages.add(content);
+            }
+            @Override
+            protected void addWarningMessage(ExtendedDataEntity dataEntity, String content) {
+                errorIndexs.add(dataEntity.getDataEntityIndex());
+                errorMessages.add(content);
+            }
+        };
+    }
+
+    // ========== 4. 构建测试数据（DynamicObjectMocker 复杂嵌套）==========
+    private ExtendedDataEntity[] buildValidatorData() {
+        // 单据一：数量超出（应触发校验错误）
+        DynamicObject billOne = new DynamicObjectMocker()
+            .add("id", 123456L)
+            .add(OutsourceSendConsts.BILLTYPEID_ID, 12334L)
+            .add(OutsourceSendConsts.BILLSTATUS, "A")
+            .add("entryentity", new DynamicObjectMocker()
+                .add("id", 1L)
+                .add("seq", 1)
+                .add("proplanentry_id", 2L)
+                .add("proplanentry", new DynamicObjectMocker()
+                    .add("id", 2L)
+                    .add("headunitfactor", 1)
+                    .add("prounitfactor", 1)
+                    .add("processsequence", 1)
+                    .add("processnumber", 10).getObject())
+                .add("proplan_id", 3L)
+                .add("material", new DynamicObjectMocker()
+                    .add("masterid.id", 4L).getObject())
+                .add("processqty", new BigDecimal(11))    // 超出 cansendqty
+                .add("cansendqty", new BigDecimal(10))
+                .add("unit", new DynamicObjectMocker()
+                    .add("id", 1L)
+                    .add("precision", 1).getObject())
+                .getCollection())
+            .getObject();
+
+        // 单据二：数量正常（校验通过）
+        DynamicObject billTwo = new DynamicObjectMocker()
+            .add("id", 123456L)
+            .add(OutsourceSendConsts.BILLTYPEID_ID, 12334L)
+            .add(OutsourceSendConsts.BILLSTATUS, "A")
+            .add("entryentity", new DynamicObjectMocker()
+                .add("id", 1L)
+                .add("seq", 1)
+                .add("proplanentry_id", 2000000L)
+                .add("proplanentry", new DynamicObjectMocker()
+                    .add("id", 2000000L)
+                    .add("headunitfactor", 1)
+                    .add("prounitfactor", 1)
+                    .add("processsequence", 1)
+                    .add("processnumber", 20).getObject())
+                .add("proplan_id", 30000000L)
+                .add("material", new DynamicObjectMocker()
+                    .add("masterid.id", 4L).getObject())
+                .add("processqty", BigDecimal.TEN)         // 等于 cansendqty
+                .add("cansendqty", BigDecimal.TEN)
+                .add("unit", new DynamicObjectMocker()
+                    .add("id", 1L)
+                    .add("precision", 1).getObject())
+                .getCollection())
+            .getObject();
+
+        return new ExtendedDataEntity[]{
+            new ExtendedDataEntity(billOne, 0, 0),
+            new ExtendedDataEntity(billTwo, 0, 0)
+        };
+    }
+
+    // ========== 5. 测试方法 ==========
+
+    @UnittestCaseInfo(
+        author = "zhang_san <zhang_san@kingdee.com>",
+        title = "Test validate should not generate error",
+        targetClass = "kd.mmc.sfc.opplugin.validator.OutSendProcessQtyValidator",
+        targetMethod = "validate",
+        lastUpdateTime = "2025-08-05 19:54:35",
+        lastUpdateAuthor = "zhang_san <zhang_san@kingdee.com>",
+        methodSignature = "null",
+        testPoints = {"Functionality"},
+        description = "Test validate should not generate error"
+    )
+    @Test
+    public void testValidate_ShouldNotGenerateError() {
+        //step 配置 Mock（所有外部查询返回空/默认值）
+        processPlanHelper.when(() -> ProcessPlanHelper.getPlanInfo(any(Set.class)))
+            .thenReturn(new HashMap<>());
+        outsourceSendHelper.when(() -> OutsourceSendHelper.getOutSendInfo(any(Set.class)))
+            .thenReturn(new HashMap<>());
+        outsourceSendHelper.when(() -> OutsourceSendHelper.getRelatedProcess(any()))
+            .thenReturn(new ArrayList<>());
+
+        //step 构建校验器和数据
+        ExtendedDataEntity[] dataEntities = buildValidatorData();
+        OutSendProcessQtyValidator validator = buildValidator();
+        validator.setEntityKey(InsideAcceptConst.FORMID);
+        validator.setDataEntities(dataEntities);
+
+        //step 执行校验
+        validator.validate();
+
+        //assert 无错误
+        assertEquals(0, errorIndexs.size());
+    }
+
+    @UnittestCaseInfo(
+        author = "zhang_san <zhang_san@kingdee.com>",
+        title = "Test validate should generate error",
+        targetClass = "kd.mmc.sfc.opplugin.validator.OutSendProcessQtyValidator",
+        targetMethod = "validate",
+        lastUpdateTime = "2025-08-05 19:54:35",
+        lastUpdateAuthor = "zhang_san <zhang_san@kingdee.com>",
+        methodSignature = "null",
+        testPoints = {"Functionality"},
+        description = "Test validate should generate error"
+    )
+    @Test
+    public void testValidate_ShouldGenerateError() {
+        //step 配置 Mock（构造会触发校验失败的数据环境）
+        Map<Long, Map<String, Object>> planInfos = new HashMap<>();
+        Map<String, Object> map = new HashMap<>(16);
+        map.put("id", 1L);
+        map.put("billno", "GXJH-20231207-00000167");
+        map.put("entryentity.higherqty", BigDecimal.ZERO);
+        map.put("entryentity.outsourcedsbqty", BigDecimal.ZERO);
+        map.put("entryentity.outsourcedqty", BigDecimal.ZERO);
+        map.put("entryentity.reportordercontrol", "B");
+        planInfos.put(2L, map);
+
+        processPlanHelper.when(() -> ProcessPlanHelper.getPlanInfo(any(Set.class)))
+            .thenReturn(planInfos);
+        outsourceSendHelper.when(() -> OutsourceSendHelper.getOutSendInfo(any(Set.class)))
+            .thenReturn(new HashMap<>());
+        outsourceSendHelper.when(() -> OutsourceSendHelper.getRelatedProcess(any()))
+            .thenReturn(new ArrayList<>());
+
+        //step 执行校验
+        ExtendedDataEntity[] dataEntities = buildValidatorData();
+        OutSendProcessQtyValidator validator = buildValidator();
+        validator.setEntityKey(InsideAcceptConst.FORMID);
+        validator.setDataEntities(dataEntities);
+        validator.validate();
+
+        //assert 应有 2 条错误
+        assertEquals(2, errorIndexs.size());
+    }
+}
+```
+
+## 要点总结
+
+1. **匿名子类重写** `addMessage` / `addErrorMessage` / `addWarningMessage` 收集错误到 List
+2. **ExtendedDataEntity 包装**：`new ExtendedDataEntity(dynamicObject, rowIndex, 0)`
+3. **setEntityKey** 设置单据标识（部分校验器依赖此值判断逻辑分支）
+4. **setDataEntities** 设置校验数据后再调用 `validate()`
+5. **断言错误数量**：`assertEquals(expectedCount, errorMessages.size())`
+6. 构造**通过和不通过两组数据**，分别验证正常和异常路径

package/vendor/kingdee-skills/cosmic-unittest/patterns/business-helper.md

@@ -0,0 +1,184 @@
+# Business Helper 测试模式
+
+## 适用范围
+
+`<模块组>-business` 工程中的静态帮助类，如 `XxxHelper`、`XxxService` 等。
+这些类通常包含大量 `public static` 方法，内部调用各种 ServiceHelper 静态方法。
+
+## 测试文件位置
+
+```
+<模块组>-business/src/test/java/kd/<包路径>/business/XxxHelperTest.java
+```
+
+与被测类保持相同的包路径。
+
+## 基类选择
+
+| 场景 | 基类 |
+|------|------|
+| 不需要 ResManager | `AbstractJunitNoDependenciesTest` |
+| 需要 ResManager（多语言） | `AbstractJunitNoDependenciesResManagerTest` |
+| 需要通用 Mock 集合 | 继承项目内 `BaseTest`（已封装常用 Mock） |
+
+## 模板结构
+
+```java
+package kd.<包路径>.business;
+
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.form.unittest.DisplayName;
+import kd.bos.servicehelper.QueryServiceHelper;
+import kd.bos.servicehelper.BusinessDataServiceHelper;
+import kd.bos.test.ext.annotaions.UnittestCaseInfo;
+import kd.bos.unittest.AbstractJunitNoDependenciesResManagerTest;
+import kd.bos.unittest.mock.DynamicObjectMocker;
+import kd.bos.unittest.mock.ReflectHelper;
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+import org.mockito.MockedStatic;
+import org.mockito.Mockito;
+
+import static org.mockito.ArgumentMatchers.*;
+import static org.mockito.Mockito.mockStatic;
+
+/**
+ * XxxHelper 单元测试
+ * @author 作者
+ * @version 1.0
+ * @date YYYY/MM/DD
+ */
+public class XxxHelperTest extends AbstractJunitNoDependenciesResManagerTest {
+
+    // 1. 声明需要 Mock 的静态类
+    MockedStatic<QueryServiceHelper> queryServiceHelper;
+    MockedStatic<BusinessDataServiceHelper> businessDataServiceHelper;
+    // 根据被测方法实际依赖添加更多...
+
+    @Before
+    public void before() {
+        // 2. 初始化 MockedStatic
+        queryServiceHelper = mockStatic(QueryServiceHelper.class);
+        businessDataServiceHelper = mockStatic(BusinessDataServiceHelper.class);
+    }
+
+    @After
+    public void after() {
+        // 3. 关闭所有 MockedStatic（必须！）
+        queryServiceHelper.close();
+        businessDataServiceHelper.close();
+    }
+
+    public void reset() {
+        // 4. 可选：在每个测试方法末尾重置状态
+        queryServiceHelper.reset();
+        businessDataServiceHelper.reset();
+    }
+
+    // ========== 测试方法 ==========
+
+    @UnittestCaseInfo(
+        author = "<name> <<name>@kingdee.com>",
+        title = "Test method description",
+        targetClass = "kd.<包路径>.business.XxxHelper",
+        targetMethod = "methodname",
+        lastUpdateTime = "yyyy-MM-dd HH:mm:ss",
+        lastUpdateAuthor = "<name> <<name>@kingdee.com>",
+        methodSignature = "public static ReturnType methodName(ParamType param)",
+        testPoints = {"Functionality"},
+        description = "Test method description"
+    )
+    @Test
+    @DisplayName("测试场景：正常路径")
+    public void testMethodName_NormalCase() {
+        //step 构建 Mock 返回数据
+        queryServiceHelper.when(() -> QueryServiceHelper.query(anyString(), anyString(), any()))
+            .thenReturn(new DynamicObjectMocker()
+                .add("id", 1L)
+                .add("billno", "TEST-001")
+                .getCollection());
+
+        //step 执行被测方法
+        Object result = XxxHelper.targetMethod(param);
+
+        //assert 断言结果
+        assertNotNull(result);
+        assertEquals(expectedValue, result);
+        reset();
+    }
+}
+```
+
+## 关键技巧
+
+### 1. 测试 protected 方法
+
+```java
+@Test
+public void testProtectedMethod() {
+    XxxHelper instance = new XxxHelper();
+    Object result = ReflectHelper.invokeProtectedMethod(
+        XxxHelper.class, instance, "protectedMethodName", param1, param2);
+    assertEquals(expected, result);
+}
+```
+
+### 2. 测试 private static 方法
+
+```java
+@Test
+public void testPrivateStaticMethod() {
+    ReflectHelper.invokeStaticMethod(
+        XxxHelper.class, "privateStaticMethodName", param1, param2);
+    // 通过 verify 或 side-effect 断言
+}
+```
+
+### 3. 使用项目 BaseTest 基类
+
+如果被测方法依赖多个常见服务（OrgUnitServiceHelper、BillTypeParamHelper 等），
+直接继承 `BaseTest`（在 `<模块组>-business/src/test/java/` 下查找）可省去重复的 Mock 初始化代码。BaseTest 已预置：
+
+- OrgUnitServiceHelper
+- BillTypeParamHelper
+- ResManager（thenAnswer 返回第一个参数）
+- SystemParamServiceHelper
+- QueryServiceHelper
+- BusinessDataServiceHelper
+- OperationServiceHelper
+- BaseDataServiceHelper
+- SaveServiceHelper
+
+### 4. CommonMockObject 工具
+
+> 此为通用工具，详见 SKILL.md 2.9 节。此处展示 business 工程的典型用法。
+
+```java
+// 获取 Mock 的 IDataModel 和 IFormView
+IDataModel model = CommonMockObject.getTestModel();
+IFormView view = CommonMockObject.getTestView();
+
+// 从 JSON 字符串构造 DynamicObject
+DynamicObject obj = CommonMockObject.getDynByString("{\"id\":1,\"name\":\"test\"}");
+
+// 从 Map 构造 DynamicObjectMocker（支持嵌套）
+DynamicObjectMocker mocker = CommonMockObject.getDynMockerByMap(map);
+```
+
+### 5. Mock 静态方法的 thenAnswer 模式
+
+> 此为通用技巧，详见 SKILL.md 2.10 节。此处展示 business 工程的典型用法。
+
+当需要根据入参动态返回时：
+
+```java
+queryServiceHelper.when(() -> QueryServiceHelper.query(anyString(), anyString(), any()))
+    .thenAnswer(invocation -> {
+        String entityName = invocation.getArgument(0);
+        if ("mmc_processplan".equals(entityName)) {
+            return mockProcessPlanData();
+        }
+        return new DynamicObjectCollection();
+    });
+```