kcode-pi 0.1.0

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

@@ -0,0 +1,205 @@
+# Business Helper 测试完整示例
+
+> 以 `AutoCompleteWorkHelper` 为例，展示 business 帮助类的完整测试写法。
+
+```java
+package kd.mmc.sfc.business;
+
+import kd.bd.mpdm.common.sfc.assist.ProcessStatus;
+import kd.bd.sbd.enums.sfc.SequenceTypeEnum;
+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.org.utils.Consts;
+import kd.bos.servicehelper.operation.OperationServiceHelper;
+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 kd.mmc.sfc.common.consts.SendWorkConst;
+import kd.mmc.sfc.common.outsourcesend.OutsourceSendConsts;
+import kd.mmc.sfc.common.processplan.ProcessPlanConsts;
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+import org.mockito.MockedStatic;
+
+import java.math.BigDecimal;
+import java.util.*;
+
+import static org.mockito.ArgumentMatchers.*;
+import static org.mockito.Mockito.*;
+
+/**
+ * 自动完工帮助类单测
+ * @author zhang_san
+ * @version 1.0
+ * @date 2025/4/14 9:18
+ */
+public class AutoCompleteWorkHelperTest extends AbstractJunitNoDependenciesResManagerTest {
+
+    // ========== 1. 声明 MockedStatic ==========
+    MockedStatic<OperationServiceHelper> operationServiceHelper;
+    MockedStatic<ProcessPlanHelper> processPlanHelper;
+    private MockedStatic<ProcessReviewHelper> processReviewHelper;
+
+    // ========== 2. @Before 初始化 ==========
+    @Before
+    public void before() {
+        operationServiceHelper = mockStatic(OperationServiceHelper.class);
+        processPlanHelper = mockStatic(ProcessPlanHelper.class);
+        processReviewHelper = mockStatic(ProcessReviewHelper.class);
+    }
+
+    // ========== 3. @After 关闭 ==========
+    @After
+    public void after() {
+        operationServiceHelper.close();
+        processPlanHelper.close();
+        processReviewHelper.close();
+    }
+
+    // ========== 4. reset 方法 ==========
+    public void reset() {
+        operationServiceHelper.reset();
+        processPlanHelper.reset();
+        processReviewHelper.reset();
+    }
+
+    // ========== 5. 测试 public static 方法 ==========
+
+    @UnittestCaseInfo(
+        author = "zhang_san <zhang_san@kingdee.com>",
+        title = "Invoke bill operate success",
+        targetClass = "kd.mmc.sfc.business.AutoCompleteWorkHelper",
+        targetMethod = "invokebilloperate",
+        lastUpdateTime = "2025-04-14 09:27:03",
+        lastUpdateAuthor = "zhang_san <zhang_san@kingdee.com>",
+        methodSignature = "protected static OperationResult invokeBillOperate(...)",
+        testPoints = {"Functionality"},
+        description = "Invoke bill operate success"
+    )
+    @Test
+    public void invokeBillOperate_Success() {
+        //step 构建查询返回数据
+        Set<String> billIds = new HashSet<>(Arrays.asList("1", "2"));
+        Set<String> entryIds = new HashSet<>(Collections.singletonList("1"));
+        Map<String, Date> dateMap = new HashMap<>();
+        dateMap.put("1", new Date());
+
+        OperationResult opResult = new OperationResult();
+        opResult.setSuccess(true);
+        operationServiceHelper.when(() -> OperationServiceHelper.executeOperate(
+                anyString(), anyString(), any(Object[].class), any(OperateOption.class)))
+            .thenReturn(opResult);
+
+        //step 执行被测方法
+        OperationResult result = AutoCompleteWorkHelper.invokeBillOperate(
+            "operation", billIds, entryIds, dateMap, "formId");
+
+        //assert 断言返回结果
+        assertTrue(result.isSuccess());
+        reset();
+    }
+
+    @Test
+    public void invokeBillOperate_Exception() {
+        //step 构建异常场景
+        Set<String> billIds = new HashSet<>(Arrays.asList("1", "2"));
+        Set<String> entryIds = new HashSet<>(Collections.singletonList("1"));
+        Map<String, Date> dateMap = new HashMap<>();
+        dateMap.put("1", new Date());
+
+        operationServiceHelper.when(() -> OperationServiceHelper.executeOperate(
+                anyString(), anyString(), any(Object[].class), any(OperateOption.class)))
+            .thenThrow(new RuntimeException("Exception"));
+
+        //step 执行被测方法（异常被内部捕获）
+        OperationResult result = AutoCompleteWorkHelper.invokeBillOperate(
+            "operation", billIds, entryIds, dateMap, "formId");
+
+        //assert 异常被捕获后仍返回成功
+        assertTrue(result.isSuccess());
+        reset();
+    }
+
+    // ========== 6. 测试 private static 方法（用 ReflectHelper）==========
+
+    @Test
+    public void testAutoProcessPlanCompleteWork_WhenProPlanBillsIsEmpty() {
+        //step 模拟 proPlanBills 为空
+        Set<Long> proPlanEntryIds = new HashSet<>();
+        proPlanEntryIds.add(1001L);
+        Map<Long, Date> allEndTimeMap = new HashMap<>();
+        allEndTimeMap.put(1001L, new Date());
+
+        //mock getProPlanBillsByEntryIds 返回空数组
+        processPlanHelper.when(() -> ProcessPlanHelper.getProPlanBillsByEntryIds(
+                proPlanEntryIds, Arrays.asList(ProcessStatus.STARTWORKER, ProcessStatus.SENDORDER)))
+            .thenReturn(new DynamicObject[0]);
+
+        //step 通过反射调用 private static 方法
+        ReflectHelper.invokeStaticMethod(AutoCompleteWorkHelper.class,
+            "autoProcessPlanCompleteWork", proPlanEntryIds, allEndTimeMap);
+
+        //assert 不应调用 invokeBillOperate
+        operationServiceHelper.verify(() -> OperationServiceHelper.executeOperate(
+            anyString(), anyString(), any(Object[].class), any(OperateOption.class)), never());
+    }
+
+    // ========== 7. 复杂数据构造示例 ==========
+
+    @Test
+    public void testAutoProcessPlanCompleteWork_MeetConditions() {
+        //step 构建满足条件的工序计划数据
+        Set<Long> proPlanEntryIds = new HashSet<>();
+        proPlanEntryIds.add(1001L);
+        Map<Long, Date> allEndTimeMap = new HashMap<>();
+        allEndTimeMap.put(1001L, new Date());
+
+        // 构建分录集合
+        DynamicObjectCollection entrys = new DynamicObjectCollection();
+        entrys.add(new DynamicObjectMocker()
+            .add(ProcessPlanConsts.ENTRY.PROCESSTATUS, ProcessStatus.STARTWORKER)
+            .add(ProcessPlanConsts.ENTRY.TOBEINSPECTQTY, new BigDecimal("0"))
+            .add(ProcessPlanConsts.ENTRY.TOBEREWORKEDQTY, new BigDecimal("0"))
+            .add(ProcessPlanConsts.ENTRY.COMPLETEQTY, new BigDecimal("10"))
+            .add(ProcessPlanConsts.ENTRY.PROCESSQTY, new BigDecimal("10"))
+            .add(OutsourceSendConsts.ENTRY.ID, 1001L)
+            .add(ProcessPlanConsts.ENTRY.PROCESSSEQUENCE, "1")
+            .add(ProcessPlanConsts.ENTRY.PROCESSNUMBER, "1001")
+            .add(ProcessPlanConsts.ENTRY.SEQUENCETYPE, SequenceTypeEnum.MAIN.getType())
+            .getObject());
+
+        // 构建单据（包含分录）
+        DynamicObject proPlanBill = new DynamicObjectMocker()
+            .add(Consts.ID, 1L)
+            .add(ProcessPlanConsts.BILLTYPE_ID, 100L)
+            .add(ProcessPlanConsts.ENTRY.ENTRYENTITY_ENTITY, entrys)
+            .getObject();
+
+        //mock
+        processPlanHelper.when(() -> ProcessPlanHelper.getProPlanBillsByEntryIds(
+                proPlanEntryIds, Arrays.asList(ProcessStatus.STARTWORKER, ProcessStatus.SENDORDER)))
+            .thenReturn(new DynamicObject[]{proPlanBill});
+
+        //step 执行
+        ReflectHelper.invokeStaticMethod(AutoCompleteWorkHelper.class,
+            "autoProcessPlanCompleteWork", proPlanEntryIds, allEndTimeMap);
+
+        //assert 应调用 executeOperate 2次
+        operationServiceHelper.verify(() -> OperationServiceHelper.executeOperate(
+            anyString(), anyString(), any(Object[].class), any(OperateOption.class)), times(2));
+    }
+}
+```
+
+## 要点总结
+
+1. **MockedStatic 三板斧**：声明 → @Before 初始化 → @After 关闭
+2. **reset()** 方法在每个 @Test 末尾调用，防止状态污染
+3. **private/protected 方法**用 `ReflectHelper` 反射调用
+4. **DynamicObjectMocker** 链式构造单据 + 分录的嵌套结构
+5. **@UnittestCaseInfo** 注解记录完整的测试元信息
+6. **断言方式**：assertEquals / assertTrue / assertFalse / assertNotNull + verify 验证调用次数

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

@@ -0,0 +1,257 @@
+# Common Module 测试完整示例
+
+> 展示 mmc-sfc-common 工程中三种测试类型的完整示例。
+
+## 1. POJO 测试示例（InvokeResultTest）
+
+```java
+package kd.mmc.sfc.common.pojo;
+
+import kd.bos.test.ext.annotaions.UnittestCaseInfo;
+import org.junit.Test;
+
+import static org.junit.Assert.*;
+
+/**
+ * InvokeResult 单元测试
+ * @author zhang_san
+ * @date 2026/02/05
+ */
+public class InvokeResultTest {
+
+    @UnittestCaseInfo(
+        author = "zhang_san <zhang_san@kingdee.com>",
+        title = "Test success with data",
+        targetClass = "kd.mmc.sfc.common.pojo.InvokeResult",
+        targetMethod = "successwithdata",
+        lastUpdateTime = "2026-02-05 15:58:24",
+        lastUpdateAuthor = "zhang_san <zhang_san@kingdee.com>",
+        methodSignature = "null",
+        testPoints = {"Functionality"},
+        description = "Test success with data"
+    )
+    @Test
+    public void testSuccessWithData() {
+        // step 准备测试数据
+        String testData = "test data";
+
+        // 执行被测方法
+        InvokeResult result = InvokeResult.success(testData);
+
+        // assert 验证结果
+        assertTrue(result.isSuccess());
+        assertEquals(testData, result.getData());
+        assertNull(result.getMessage());
+    }
+
+    @Test
+    public void testSuccessWithoutParams() {
+        //step 执行被测方法
+        InvokeResult result = InvokeResult.success();
+
+        //assert 验证结果
+        assertTrue(result.isSuccess());
+        assertNull(result.getData());
+    }
+
+    @Test
+    public void testFailureWithMessage() {
+        // step
+        InvokeResult result = InvokeResult.failure("error message");
+
+        // assert
+        assertFalse(result.isSuccess());
+        assertEquals("error message", result.getMessage());
+    }
+
+    @Test
+    public void testGetSetMessage() {
+        // step
+        InvokeResult result = new InvokeResult();
+        result.setMessage("test message");
+
+        // assert
+        assertEquals("test message", result.getMessage());
+    }
+
+    @Test
+    public void testToString() {
+        // step
+        InvokeResult result = new InvokeResult();
+        result.setSuccess(true);
+        result.setMessage("test message");
+        result.setData("test data");
+
+        String str = result.toString();
+
+        // assert
+        assertTrue(str.contains("success=true"));
+        assertTrue(str.contains("message=test message"));
+        assertTrue(str.contains("data=test data"));
+    }
+}
+```
+
+## 2. 枚举测试示例（PushOperationCodeEnumTest）
+
+```java
+package kd.mmc.sfc.common.enums;
+
+import kd.bos.test.ext.annotaions.UnittestCaseInfo;
+import kd.bos.unittest.AbstractJunitNoDependenciesTest;
+import kd.mmc.sfc.common.processmaterial.ProcessMaterialConsts.OPERATION_CONST;
+import org.junit.Test;
+
+/**
+ * PushOperationCodeEnum 单元测试
+ * @author zhang_san
+ * @date 2025/6/24
+ */
+public class PushOperationCodeEnumTest extends AbstractJunitNoDependenciesTest {
+
+    @UnittestCaseInfo(
+        author = "zhang_san <zhang_san@kingdee.com>",
+        title = "Match push target bill empty operation key returns empty string",
+        targetClass = "kd.mmc.sfc.common.enums.PushOperationCodeEnum",
+        targetMethod = "matchpushtargetbill",
+        lastUpdateTime = "2025-06-24 10:55:45",
+        lastUpdateAuthor = "zhang_san <zhang_san@kingdee.com>",
+        methodSignature = "public static String matchPushTargetBill(String operationKey)",
+        testPoints = {"Functionality"},
+        description = "Match push target bill empty operation key returns empty string"
+    )
+    @Test
+    public void matchPushTargetBill_EmptyOperationKey_ReturnsEmptyString() {
+        // step 空操作标识
+        String result = PushOperationCodeEnum.matchPushTargetBill("");
+
+        // assert
+        assertEquals("", result);
+    }
+
+    @Test
+    public void matchPushTargetBill_ValidOperationKey_ReturnsTargetBill() {
+        // step 有效操作标识
+        String result = PushOperationCodeEnum.matchPushTargetBill(
+            OPERATION_CONST.RETURNAPPLYORDER);
+
+        // assert 返回目标单据标识
+        assertEquals("qcpp_manuinspecapply", result);
+    }
+}
+```
+
+## 3. 工具类测试示例（BillPushUtilTest）
+
+```java
+package kd.mmc.sfc.common.utils;
+
+import kd.bos.dataentity.OperateOption;
+import kd.bos.entity.botp.runtime.ConvertOperationResult;
+import kd.bos.entity.botp.runtime.PushArgs;
+import kd.bos.entity.botp.runtime.SourceBillReport;
+import kd.bos.entity.datamodel.ListSelectedRow;
+import kd.bos.servicehelper.botp.ConvertServiceHelper;
+import kd.bos.test.ext.annotaions.UnittestCaseInfo;
+import kd.mmc.sfc.common.BaseTest;  // common 包自带的 BaseTest
+import org.junit.Test;
+import org.mockito.MockedConstruction;
+import org.mockito.MockedStatic;
+import org.mockito.Mockito;
+
+import java.util.*;
+import java.util.stream.*;
+
+import static org.mockito.ArgumentMatchers.*;
+import static org.mockito.Mockito.*;
+
+/**
+ * BillPushUtil 单元测试
+ * @author zhang_san
+ * @date 2025/4/21
+ */
+public class BillPushUtilTest extends BaseTest {
+
+    // ========== 继承 BaseTest，自动拥有常用 Mock ==========
+    // 无需自行声明 queryServiceHelper、businessDataServiceHelper 等
+
+    @UnittestCaseInfo(
+        author = "zhang_san <zhang_san@kingdee.com>",
+        title = "Test do push",
+        targetClass = "kd.mmc.sfc.common.utils.BillPushUtil",
+        targetMethod = "dopush",
+        lastUpdateTime = "2025-04-21 15:58:57",
+        lastUpdateAuthor = "zhang_san <zhang_san@kingdee.com>",
+        methodSignature = "public static ConvertOperationResult doPush(...)",
+        testPoints = {"Functionality"},
+        description = "Test do push"
+    )
+    @Test
+    public void testDoPush() {
+        // 使用 try-with-resources 管理方法级 Mock
+        try (MockedStatic<ConvertServiceHelper> convertServiceHelper =
+                 mockStatic(ConvertServiceHelper.class);
+             // MockedConstruction：Mock 构造函数
+             MockedConstruction<PushArgs> pushArgsMock =
+                 Mockito.mockConstruction(PushArgs.class)) {
+
+            //step 准备数据
+            ListSelectedRow row = mock(ListSelectedRow.class);
+
+            //step 执行
+            BillPushUtil.doPush("sourcebill", "targetbill", "ruleid",
+                new HashMap<>(), Stream.of(row).collect(Collectors.toList()));
+
+            //assert 正常执行
+            convertServiceHelper.when(() -> ConvertServiceHelper.push(any()))
+                .thenReturn(null);
+
+            //step 空列表返回 null
+            ConvertOperationResult result = BillPushUtil.doPush(
+                "sourcebill", "targetbill", "ruleid",
+                new HashMap<>(), new ArrayList<>());
+
+            //assert
+            assertNull(result);
+        }
+    }
+
+    @Test
+    public void testGetErrorMessageFromConverResult() {
+        //step 构建失败的转换结果
+        ConvertOperationResult mockResult = mock(ConvertOperationResult.class);
+        when(mockResult.isSuccess()).thenReturn(false);
+        when(mockResult.getMessage()).thenReturn("Initial Error");
+
+        SourceBillReport mockReport = mock(SourceBillReport.class);
+        when(mockReport.isFullSuccess()).thenReturn(false);
+        when(mockReport.getFailMessage()).thenReturn("Bill Error");
+        when(mockResult.getBillReports()).thenReturn(
+            new ArrayList<SourceBillReport>() {{ add(mockReport); }});
+
+        //step 执行
+        String errorMsg = BillPushUtil.getErrorMessageFromConverResult(mockResult);
+
+        //assert 包含错误信息
+        assertTrue(errorMsg.contains("Bill Error"));
+    }
+}
+```
+
+## 要点总结
+
+### POJO 测试
+- **零 Mock**，纯 Java 对象操作
+- 覆盖 getter/setter、工厂方法、toString、Builder 模式
+- 无需基类，测试最简洁
+
+### 枚举测试
+- 继承 `AbstractJunitNoDependenciesTest`
+- 测试匹配方法的有效值 / 无效值 / 边界值
+- 代码量最少的测试类型
+
+### 工具类测试
+- 继承 common 包 `BaseTest`（预置 10 个 MockedStatic）
+- 额外 Mock 用 try-with-resources 管理
+- `MockedConstruction` 可 Mock 类的构造函数（`new Xxx()` 内部创建的对象）
+- 与 business 工程 BaseTest 的区别：common 的 BaseTest 多了 `EntityMetadataCache` Mock