cloudcc-cli 2.2.7 → 2.2.9

package/src/triggers/doc.js

@@ -6,304 +6,340 @@ const path = require("path");
 
 function generateFullMarkdownDoc() {
     const lines = [
-        "# CloudCC 触发器开发指南",
+        "# CloudCC 触发器使用总结",
         "",
-        "> 本文档参考 CloudCC 官方「触发器」文档整理而成：[触发器](https://help.cloudcc.cn/product03/hong-fa-qi/)。  ",
-        "> 目标：帮助开发者正确编写、调试和使用触发器，理解触发时机、可用变量、与自定义类/Email/时间工具的协同，以及避免循环调用等常见坑。",
+        "> 基于 25 个生产环境触发器实例分析。",
+        "> 文档版本：v1.0",
+        "> 更新时间：2026-03-24",
         "",
         "---",
         "",
-        "## 1. 概念与入口",
+        "## 一、什么是触发器",
         "",
-        "### 1.1 什么是触发器",
+        "CloudCC 触发器是完全符合 Java 语法规范的代码，在特定业务事件发生时自动执行，实现业务逻辑自动化处理。",
         "",
-        "- 触发器是在特定数据操作事件发生**之前或之后**执行的一段 Java 代码。  ",
-        "- 典型触发时间：",
-        "  - 在对象记录插入数据库之前 / 之后",
-        "  - 在对象记录更新之前 / 之后",
-        "  - 在对象记录删除之前 / 之后",
-        "  - 在审批相关场景（`approval`）中  ",
-        "- 主要用于：",
-        "  - 复杂字段校验（必填、多字段联动、一致性约束）",
-        "  - 自动带值 / 派生字段写入",
-        "  - 与其他对象联动更新",
+        "触发器本质：",
+        "- 一段 Java 代码，运行在 CloudCC 平台沙箱环境中",
+        "- 使用 CCService、CCObject 等平台提供的 API 类",
+        "- 在数据变更的特定时刻（前/后）自动触发执行",
         "",
-        "### 1.2 触发器开发入口",
+        "## 二、触发器能干什么",
         "",
-        "两种方式创建触发器：",
+        "### 2.1 核心能力",
         "",
-        "1. **通过开发者平台**  ",
-        "   - 登录系统 → 右上角头像 → 「开发者平台」（管理员简档可见）  ",
-        "   - 左侧菜单：`扩展 → 触发器 → 新建`",
+        "| 能力 | 说明 | 示例 |",
+        "|------|------|------|",
+        "| 自动赋值 | 在记录保存前自动计算并填充字段 | 个人业绩/部门业绩自动赋值 |",
+        "| 数据校验 | 阻止不符合业务规则的数据保存 | 预算金额校验、审批金额验证 |",
+        "| 关联更新 | 修改一条记录时自动更新关联记录 | 回款明细汇总到收款计划 |",
+        "| 自动生成 | 根据业务规则自动创建新记录 | 审批通过后自动生成回款记录 |",
+        "| 权限控制 | 自动设置数据共享权限 | 按部门/人员自动共享 |",
+        "| 状态同步 | 审批状态变更后同步更新相关字段 | 预算审批状态回写 |",
+        "| 汇总计算 | 实时汇总明细数据到主记录 | 部门业绩字段汇总 |",
         "",
-        "2. **在对象后台设置中创建**  ",
-        "   - 进入目标对象的后台设置（对象管理）  ",
-        "   - 将页面滚动到底部，在「触发器」区域点击「新建`",
+        "### 2.2 技术能力（基于 CCService API）",
         "",
-        "---",
-        "",
-        "## 2. 触发器配置项与触发时机",
-        "",
-        "### 2.1 基本配置",
-        "",
-        "- **名称**：汉字说明，用于描述触发器完成的功能  ",
-        "- **触发对象**：在哪个对象上执行触发器操作  ",
-        "- **触发时间（Trigger Event）**：决定在什么时机触发",
-        "",
-        "常用触发时间包括：",
-        "",
-        "- `beforeInsert`：新建/复制记录行满足触发条件前执行  ",
-        "- `beforeUpdate`：编辑记录行满足触发条件前执行  ",
-        "- `beforeUpsert`：新建和编辑/复制统一入口前执行  ",
-        "- `beforeDelete`：删除记录前执行  ",
-        "- `afterInsert`：新建/复制记录后执行（可获取记录 ID）  ",
-        "- `afterUpdate`：修改记录后执行  ",
-        "- `afterUpsert`：新建或编辑/复制后执行  ",
-        "- `afterDelete`：删除记录后执行  ",
-        "- `afterInsertCommit`：插入事务提交后执行，**报错不会回滚主事务**  ",
-        "- `afterUpdateCommit`：更新提交后执行，报错不会回滚  ",
-        "- `afterUpsertCommit`：保存提交后执行，报错不会回滚  ",
-        "- `afterDeleteCommit`：删除提交后执行，报错不会回滚  ",
-        "- `approval`：审批流程相关触发",
-        "",
-        "**提示**：  ",
-        "`before*` 阶段通常用于**校验与字段赋值**；`after*` 阶段适合做**关联对象更新、日志记录、异步操作触发**等。",
-        "",
-        "---",
-        "",
-        "## 3. 触发器中可用变量与基础语法",
-        "",
-        "### 3.1 可直接使用的变量",
+        "```java",
+        "// 1. 新增记录",
+        "CCObject opp = new CCObject(\"Opportunity\");",
+        "opp.put(\"name\", \"value\");",
+        "cs.insert(opp);",
+        "",
+        "// 2. 查询记录（指定字段）",
+        "List<CCObject> opps1 = cs.cqueryByFields(",
+        "  \"Opportunity\",",
+        "  \"khmc__c='\" + record_new.get(\"id\") + \"'\",",
+        "  \"id,name,createdate\"",
+        ");",
         "",
-        "- `(UserInfo) userInfo`：当前操作用户信息  ",
-        "- `(Map) record_new`：当前记录的**最新值**（新建/修改后）  ",
-        "- `(Map) record_old`：当前记录的**旧值**（修改前），在 `insert` 场景通常为 `null`  ",
-        "- `trigger`：触发器上下文对象，可用于添加错误提示等",
+        "// 3. 查询记录（全部字段）",
+        "List<CCObject> opps2 = cs.cquery(",
+        "  \"Opportunity\",",
+        "  \"khmc__c='\" + record_new.get(\"id\") + \"'\"",
+        ");",
         "",
-        "### 3.2 常用语法与含义",
+        "// 4. 复杂查询",
+        "List<CCObject> ccobjs = cs.cqlQuery(",
+        "  \"Opportunity\",",
+        "  \"select sum(amount) as sumAmount from Opportunity where khmc='0012001238ytwuiw'\"",
+        ");",
         "",
-        "| 语法                                   | 返回值   | 含义                               |",
-        "|----------------------------------------|----------|------------------------------------|",
-        "| `record_new.get(\"字段API\")`            | String   | 获取记录中字段的最新值            |",
-        "| `record_new.put(\"字段API\", \"字段值\")`  | void     | 为记录的某字段赋值                |",
-        "| `record_old.get(\"字段API\")`            | String   | 获取记录中字段的前一个值          |",
-        "| `record_old == null`                   | boolean  | 在 `beforeUpsert/afterUpsert` 中识别是否为新建 |",
-        "| `trigger.addErrorMessage(\"提示内容\")`  | void     | 在保存前用于提示并中止保存        |",
+        "// 5. 修改/删除",
+        "cs.update(opp);",
+        "cs.delete(opp);",
         "",
-        "**提示**：  ",
-        "字段名使用**字段 API 名称**（如 `project_manager`、`start_date`），自定义字段一般以 `__c` 结尾。",
+        "// 6. 发送邮件通知",
+        "SendEmail sendEmail = new SendEmail(userInfo);",
+        "sendEmail.sendMailFromSystem(toAddress, ccAddress, bccAddress, subject, content, isText);",
+        "```",
         "",
         "---",
         "",
-        "## 4. 常见案例",
-        "",
-        "### 4.1 案例 1：字段联动带值（查询赋值）",
-        "",
-        "**需求**  ",
-        "在项目对象中，将当前项目经理的邮箱自动带入本对象的 `email` 字段。  ",
+        "## 三、触发器的触发时机详解",
         "",
-        "**触发事件**：`beforeUpsert`",
-        "",
-        "**代码示例**",
+        "### 3.1 beforeUpsert（创建或更新前）",
+        "- 执行时机：记录保存之前，数据尚未写入数据库",
+        "- 典型用途：自动计算字段、数据格式校验、阻止非法数据保存、自动填充默认值",
+        "- 生产实例：个人业绩/部门业绩赋值、计算产研成本/净业绩、生成部门/个人业绩",
         "",
         "```java",
-        "String managerId = record_new.get(\"project_manager\") == null ? \"\" : record_new.get(\"project_manager\") + \"\"; // 新值",
-        "String managerId_old = record_old == null || record_old.get(\"project_manager\") == null ? \"\" : record_old.get(\"project_manager\") + \"\"; // 旧值",
-        "",
-        "// 项目经理字段新值和老值不相同时判定为该字段值发生改变，需重新查询用户表获取邮箱带到本记录中",
-        "if (!managerId.equals(managerId_old)) {",
-        "  List<CCObject> userlist = cquery(\"User\", \"id='\" + managerId + \"'\");",
-        "  if (userlist.size() > 0) {",
-        "    String email = userlist.get(0).get(\"email\") == null ? \"\" : userlist.get(0).get(\"email\") + \"\";",
-        "    record_new.put(\"email\", email);",
-        "  }",
+        "// beforeUpsert 示例",
+        "CCObject record = (CCObject) data.get(\"record\");",
+        "BigDecimal income = record.getBigDecimal(\"ysr\");",
+        "BigDecimal cost = record.getBigDecimal(\"cycb\");",
+        "BigDecimal net = income.subtract(cost);",
+        "record.put(\"jyj\", net);",
+        "if (net.compareTo(BigDecimal.ZERO) < 0) {",
+        "  throw new Exception(\"毛利不能为负数！\");",
         "}",
         "```",
         "",
-        "要点：",
-        "- 使用 `record_new` / `record_old` 比较判断字段是否变更，**避免无谓查询与写入**。",
-        "- 查询用户对象时使用 `cquery(\"User\", ...)`。",
-        "",
-        "### 4.2 案例 2：复杂必填校验",
-        "",
-        "**需求**  ",
-        "当项目经理不为空时，项目开始日期与结束日期必填，否则不允许保存。",
+        "### 3.2 afterInsert（创建后）",
+        "- 执行时机：记录创建成功后（可获取 ID）",
+        "- 典型用途：基于新记录 ID 创建关联记录、发送创建通知、初始化关联数据",
+        "- 生产实例：根据净业绩拆分生成净业绩拆分回款",
         "",
-        "**触发时间**：`beforeUpsert`",
+        "```java",
+        "// afterInsert 示例",
+        "CCObject newRecord = (CCObject) data.get(\"record\");",
+        "String recordId = newRecord.getString(\"id\");",
+        "CCObject hkRecord = new CCObject(\"Huikuan\");",
+        "hkRecord.put(\"mingxi__c\", recordId);",
+        "hkRecord.put(\"je\", newRecord.get(\"je\"));",
+        "cs.insert(hkRecord);",
+        "```",
         "",
-        "**代码示例**",
+        "### 3.3 afterUpsert（创建或更新后）",
+        "- 执行时机：记录保存成功后（新增或修改）",
+        "- 典型用途：汇总数据到父记录、触发下游流程、更新关联记录状态",
+        "- 生产实例：金额汇总到收款计划、更新部门业绩字段、更新回款明细",
         "",
         "```java",
-        "String managerId = record_new.get(\"project_manager\") == null ? \"\" : record_new.get(\"project_manager\") + \"\"; // 项目经理",
-        "String start_date = record_new.get(\"start_date\") == null ? \"\" : record_new.get(\"start_date\") + \"\";         // 项目开始日期",
-        "String end_date = record_new.get(\"end_date\") == null ? \"\" : record_new.get(\"end_date\") + \"\";               // 项目结束日期",
-        "",
-        "if (!\"\".equals(managerId) && (\"\".equals(start_date) || \"\".equals(end_date))) {",
-        "   trigger.addErrorMessage(\"请填写项目开始日期及项目结束日期\");",
+        "// afterUpsert 示例 - 汇总金额到父记录",
+        "CCObject detail = (CCObject) data.get(\"record\");",
+        "String planId = detail.getString(\"skjh__c\");",
+        "List<CCObject> plans = cs.cqueryByFields(",
+        "  \"ShoukuanJihua\",",
+        "  \"id='\" + planId + \"'\",",
+        "  \"id,shyjje,yishouje\"",
+        ");",
+        "if (!plans.isEmpty()) {",
+        "  CCObject plan = plans.get(0);",
+        "  BigDecimal current = plan.getBigDecimal(\"yishouje\");",
+        "  BigDecimal detailAmount = detail.getBigDecimal(\"je\");",
+        "  plan.put(\"yishouje\", current.add(detailAmount));",
+        "  cs.update(plan);",
         "}",
         "```",
         "",
-        "要点：",
-        "- 通过 `trigger.addErrorMessage` 阻断保存并提示用户。",
-        "- 适合放在 `beforeInsert` / `beforeUpdate` / `beforeUpsert` 等阶段。",
+        "### 3.4 afterDelete（删除后）",
+        "- 执行时机：记录删除成功后",
+        "- 典型用途：清理关联数据、反向汇总更新",
+        "- 生产实例：回款明细删除后重新计算回款金额",
         "",
-        "---",
+        "### 3.5 approval（审批时）",
+        "- 执行时机：记录提交审批或审批通过时",
+        "- 典型用途：审批前校验、审批通过后执行业务操作",
+        "- 生产实例：更新拆分审批状态、订单审批判断、审批通过计算剩余欠款",
         "",
-        "## 5. 进阶用法与注意事项",
+        "---",
         "",
-        "### 5.1 触发器可直接引用的参数",
+        "## 四、为什么要用触发器",
         "",
-        "- `UserInfo userInfo`：当前操作用户  ",
-        "- `Map record_new` / `Map record_old`",
+        "### 4.1 解决的核心问题",
         "",
-        "取字段值时直接使用字段 API 名称：",
+        "| 问题 | 传统方案 | 触发器方案 |",
+        "|------|----------|------------|",
+        "| 数据一致性 | 依赖用户手动操作，容易遗漏 | 自动执行，保证数据准确 |",
+        "| 业务规则执行 | 前端校验可绕过 | 统一在平台层执行，无法绕过 |",
+        "| 跨对象联动 | 需要多次手动操作 | 自动关联更新 |",
+        "| 审批复杂逻辑 | 审批流配置难以承载 | Java 代码可实现复杂逻辑 |",
+        "| 实时性要求 | 定时任务有延迟 | 实时触发，立即执行 |",
         "",
-        "```java",
-        "String name = record_new.get(\"name\") == null ? \"\" : record_new.get(\"name\") + \"\";",
-        "```",
+        "### 4.2 与其他方案对比",
         "",
-        "### 5.2 循环调用限制",
+        "| 方案 | 优点 | 缺点 | 适用场景 |",
+        "|------|------|------|----------|",
+        "| 触发器 | 实时、自动、无法绕过 | 需要 Java 开发能力 | 核心业务逻辑 |",
+        "| 审批流 | 配置简单、可视化 | 逻辑能力有限 | 简单审批流程 |",
+        "| 工作流 | 可视化编排 | 复杂逻辑实现困难 | 跨系统流程编排 |",
+        "| 定时任务 | 适合批量处理 | 有延迟 | 数据同步、报表生成 |",
         "",
-        "触发器之间可以间接导致**循环调用**，例如：",
-        "- 在客户对象的 `update` 触发器中更新业务机会  ",
-        "- 在业务机会对象的 `update` 触发器中又更新客户（再次触发客户的 `update` 触发器）  ",
+        "---",
         "",
-        "如果在触发器中不加条件控制，可能形成无限循环。平台限制：",
-        "- **最多允许 3 次循环调用**  ",
-        "- 超过 3 次系统会报错提示并终止执行",
+        "## 五、典型业务场景",
+        "",
+        "### 5.1 财务业绩管理（核心场景）",
+        "",
+        "```text",
+        "订单 (Order)",
+        "  └─ approval：审批判断",
+        "预算 (Budget)",
+        "  ├─ beforeUpsert：计算产研成本/净业绩",
+        "  └─ afterUpsert：自动拆分/生成回款",
+        "净业绩拆分 (jyjcf)",
+        "  ├─ beforeUpsert：生成部门/个人业绩",
+        "  └─ afterUpsert：校验金额累计是否超预算",
+        "部门业绩 (bmyj)",
+        "  ├─ afterUpsert：更新部门业绩字段",
+        "  └─ afterUpdate：汇总部门资金池",
+        "回款明细 (cloudccproceeddetail)",
+        "  ├─ afterInsert：生成净业绩拆分回款",
+        "  ├─ afterUpsert：金额汇总到收款计划",
+        "  ├─ afterUpsert：更新回款明细",
+        "  └─ afterDelete：回款明细删除",
+        "```",
         "",
-        "建议：",
-        "- 在跨对象更新时增加「状态字段」或「字段变更判断」作为保护条件  ",
-        "- 避免在 A 的触发器中无条件更新 B，同时在 B 的触发器中又无条件更新 A  ",
-        "- 将复杂联动逻辑尽量下沉到自定义类中集中处理",
+        "### 5.2 费用报销管理",
         "",
-        "### 5.3 触发器中发送邮件通知",
+        "```text",
+        "费用报销提交",
+        "  -> approval 触发器：验证审批时校验预算（报销金额 <= 预算余额）",
+        "审批通过",
+        "  -> approval 触发器：计算剩余欠款（借款 - 报销）",
+        "```",
         "",
-        "触发器可以使用 `SendEmail` 发送系统邮件：",
+        "### 5.3 借款还款管理",
         "",
-        "```java",
-        "SendEmail sendEmail = new SendEmail(userInfo);",
+        "| 触发器 | 对象 | 时机 | 作用 |",
+        "|--------|------|------|------|",
+        "| 借款单触发器 | 借款单 | beforeUpsert | 借款前校验、自动计算 |",
+        "| 还款记录审批通过更新借款单 | 还款记录 | approval | 审批后回写借款单 |",
         "",
-        "// 直接发送邮件",
-        "sendEmail.sendMailFromSystem(",
-        "  new String[]{\"to@example.com\"},     // 收件人",
-        "  new String[]{\"cc@example.com\"},     // 抄送",
-        "  new String[]{\"bcc@example.com\"},    // 密送",
-        "  \"邮件主题\",",
-        "  \"邮件内容\",",
-        "  true                                // 是否文本邮件",
-        ");",
+        "---",
         "",
-        "// 使用邮件模板发送",
-        "sendEmail.sendEmailNew(",
-        "  \"emailTemplateId\",",
-        "  new String[]{\"to@example.com\"},",
-        "  new String[]{\"cc@example.com\"},",
-        "  new String[]{\"bcc@example.com\"},",
-        "  record_new.get(\"id\") + \"\"           // 关联记录 ID",
-        ");",
-        "```",
+        "## 六、触发器开发最佳实践",
         "",
-        "### 5.4 获取邮件模板内容",
+        "### 6.1 代码规范",
         "",
         "```java",
-        "/**",
-        " * lang：语言",
-        " * emailtemplateid：邮件模板ID",
-        " * id：记录id（可选）",
-        " */",
-        "Map<String, String> m = this.getMessageByTemplateId(lang, emailtemplateid, record_new.get(\"id\") + \"\");",
-        "",
-        "// 邮件标题",
-        "String subject = m.get(\"subject\");",
-        "// 邮件内容",
-        "String content = m.get(\"context\");",
-        "// 邮件是否为文本形式",
-        "String isText = m.get(\"istext\");",
+        "try {",
+        "  CCObject record = (CCObject) data.get(\"record\");",
+        "  cs.update(record);",
+        "} catch (Exception e) {",
+        "  System.out.println(\"触发器执行失败：\" + e.getMessage());",
+        "  throw new Exception(\"业务校验失败：\" + e.getMessage());",
+        "}",
         "```",
         "",
-        "可以先获取模板内容，再根据业务需要调整后发送。",
+        "### 6.2 性能优化",
         "",
-        "### 5.5 TimeUtil：多时区时间支持",
+        "```java",
+        "// 推荐：字段过滤，只查询需要的字段",
+        "List<CCObject> records = cs.cqueryByFields(",
+        "  \"Object__c\",",
+        "  \"status__c='active'\",",
+        "  \"id,name,amount__c\"",
+        ");",
         "",
-        "与自定义类中用法相同，触发器也应使用 `TimeUtil` 来处理与时区相关的时间：",
+        "// 推荐：批量更新，降低递归风险",
+        "cs.updateLt(records);",
+        "```",
         "",
-        "- 获取当前时间（按用户时区）：",
+        "### 6.3 避免递归触发",
         "",
         "```java",
-        "TpSysTask task = new TpSysTask();",
-        "task.setBeginTime(TimeUtil.getNowDate(userInfo));",
+        "// 方法 1：使用 updateLt",
+        "cs.updateLt(records);",
+        "",
+        "// 方法 2：增加标志位（示例）",
+        "if (\"true\".equals(System.getProperty(\"trigger.running\"))) {",
+        "  return;",
+        "}",
+        "System.setProperty(\"trigger.running\", \"true\");",
+        "cs.update(record);",
+        "System.setProperty(\"trigger.running\", \"false\");",
         "```",
         "",
-        "- 获取带时区的 `SimpleDateFormat`：",
+        "---",
         "",
-        "```java",
-        "SimpleDateFormat myDateFormat = TimeUtil.getSimpleDateFormat(\"yyyy-MM-dd\", userInfo);",
-        "```",
+        "## 七、触发器调试与监控",
         "",
-        "- 获取带时区的 `Calendar`：",
+        "### 7.1 日志记录",
         "",
         "```java",
-        "Calendar cal = TimeUtil.getCalendar(userInfo);",
+        "System.out.println(\"=== 触发器开始执行 ===\");",
+        "System.out.println(\"对象：\" + record.getSObjectName());",
+        "System.out.println(\"操作：\" + data.get(\"action\"));",
+        "System.out.println(\"记录 ID：\" + record.get(\"id\"));",
         "```",
         "",
-        "---",
-        "",
-        "## 6. 与 CCService / 自定义类的协同",
+        "### 7.2 常见问题排查",
         "",
-        "### 6.1 在触发器中使用 CCService",
+        "| 问题 | 可能原因 | 解决方案 |",
+        "|------|----------|----------|",
+        "| 触发器不执行 | 未激活、触发时机不对 | 检查状态与配置 |",
+        "| 递归触发 | 更新操作再次触发触发器 | 使用 `updateLt` 或增加条件判断 |",
+        "| 性能问题 | 查询数据量过大 | 增加查询条件、字段过滤 |",
+        "| 数据不一致 | 触发器执行失败 | 增加异常处理与关键日志 |",
         "",
-        "触发器中同样可以实例化并使用 `CCService` 进行增删改查：",
+        "---",
         "",
-        "```java",
-        "CCService cs = new CCService((UserInfo) userInfo);",
-        "",
-        "// 示例：根据当前记录字段查询机会",
-        "String accountId = record_new.get(\"khmc__c\") == null ? \"\" : record_new.get(\"khmc__c\") + \"\";",
-        "if (!\"\".equals(accountId)) {",
-        "  List<CCObject> opps = cs.cquery(",
-        "    \"Opportunity\",",
-        "    \"khmc__c = '\" + accountId + \"'\",",
-        "    \"jine__c desc\"",
-        "  );",
-        "  // TODO: 根据查询结果执行相应逻辑",
-        "}",
-        "```",
+        "## 八、总结",
         "",
-        "具体 `CCService` 能力详见 `custom-class-dev.md`。",
+        "### 8.1 触发器价值",
+        "1. 自动化：减少人工操作，降低出错率",
+        "2. 一致性：保证数据准确与规则统一执行",
+        "3. 实时性：业务变更立即响应",
+        "4. 灵活性：Java 代码可承载复杂逻辑",
         "",
-        "### 6.2 将复杂逻辑下沉到自定义类",
+        "### 8.2 适用与不适用场景",
         "",
-        "推荐模式：",
+        "**适合使用触发器：**",
+        "- 需要实时数据联动",
+        "- 核心业务规则校验",
+        "- 跨对象数据同步",
+        "- 审批流程复杂逻辑",
+        "- 自动创建或更新关联记录",
         "",
-        "1. 触发器中只负责：",
-        "   - 判断是否需要执行逻辑（字段是否变化、状态是否满足、避免循环等）",
-        "   - 准备必需参数（如 `userInfo`、`record_new` / `record_old` 等）",
-        "2. 将主要业务逻辑封装到自定义类方法中：",
+        "**不适合使用触发器：**",
+        "- 简单字段默认值（优先配置化能力）",
+        "- 大批量离线数据处理",
+        "- 跨系统集成调用",
+        "- 强交互型前端界面逻辑",
         "",
-        "```java",
-        "// 触发器中",
-        "if (/* 条件满足 */) {",
-        "  new ProjectService(userInfo).handleAfterUpdate(record_old, record_new);",
-        "}",
-        "```",
+        "### 8.3 触发器开发 Checklist",
         "",
-        "好处：",
-        "- 逻辑集中、可复用、易测试  ",
-        "- 触发器代码保持精简，可读性更高",
+        "- [ ] 明确触发时机（before/after/approval）",
+        "- [ ] 评估并规避递归触发风险",
+        "- [ ] 添加异常处理与关键日志",
+        "- [ ] 覆盖边界条件测试",
+        "- [ ] 完成大数据量场景性能测试",
         "",
         "---",
         "",
-        "## 7. 触发器开发 Checklist",
-        "",
-        "- [ ] 已选择正确的**触发对象**与**触发时间**（before/after/commit/approval）  ",
-        "- [ ] 校验逻辑集中在 `before*` 阶段，并通过 `trigger.addErrorMessage` 给出清晰提示  ",
-        "- [ ] 使用 `record_new` / `record_old` 判断字段是否变化，避免不必要的数据库操作  ",
-        "- [ ] 涉及跨对象更新时，已经考虑并避免循环调用（尤其是双向更新）  ",
-        "- [ ] 发送邮件时使用 `SendEmail` / 模板，且确认模板与收件人配置正确  ",
-        "- [ ] 与时间相关逻辑使用 `TimeUtil`，避免跨时区错误  ",
-        "- [ ] 复杂业务逻辑拆分到自定义类中，通过触发器调用，触发器本身保持简洁  ",
-        "- [ ] 已在测试环境完整验证：新建、编辑、删除、审批等全场景，确认不会出现循环触发或异常回滚问题  ",
+        "## 附录：25 个生产触发器清单",
+        "",
+        "| # | 名称 | 对象 | 时机 | 状态 |",
+        "|---|------|------|------|------|",
+        "| 1 | 个人业绩/部门业绩赋值 | 对外付款 | beforeUpsert | ✅ |",
+        "| 2 | 个人业绩/部门业绩赋值 | 费用报销 | beforeUpsert | ❌ |",
+        "| 3 | 本部业绩统计 | 本部业绩统计 | beforeUpsert | ✅ |",
+        "| 4 | 更新拆分审批状态 | 预算 | approval | ✅ |",
+        "| 5 | 订单审批判断 | 订单 | approval | ✅ |",
+        "| 6 | 根据净业绩拆分生成净业绩拆分回款 | 回款明细 | afterInsert | ✅ |",
+        "| 7 | 金额汇总到收款计划 | 回款明细 | afterUpsert | ✅ |",
+        "| 8 | 回款明细删除 | 回款明细 | afterDelete | ❌ |",
+        "| 9 | 计算产研成本/净业绩 | 预算 | beforeUpsert | ✅ |",
+        "| 10 | 保证金回款记录 | 概算 | afterUpdate | ✅ |",
+        "| 11 | 校验金额累计是否超预算 | 净业绩拆分 | afterUpsert | ✅ |",
+        "| 12 | 更新部门业绩字段 | 部门业绩 | afterUpsert | ✅ |",
+        "| 13 | 汇总部门资金池 | 部门业绩 | afterUpdate | ✅ |",
+        "| 14 | 编辑更新部门业绩 | 净业绩拆分回款 | beforeUpsert | ✅ |",
+        "| 15 | 生成部门/个人业绩 | 净业绩拆分 | beforeUpsert | ✅ |",
+        "| 16 | 更新回款明细 | 回款明细 | afterUpsert | ✅ |",
+        "| 17 | 新建自动拆分/审批通过自动生成回款 | 预算 | afterUpsert | ✅ |",
+        "| 18 | 提交审批验证金额 | 对外付款 | approval | ❌ |",
+        "| 19 | 还款记录审批通过更新借款单 | 还款记录 | approval | ✅ |",
+        "| 20 | 审批通过计算剩余欠款 | 费用报销 | approval | ✅ |",
+        "| 21 | 借款单触发器 | 借款单 | beforeUpsert | ✅ |",
+        "| 22 | 创建编辑项目任务时判断 | 项目任务 | beforeUpsert | ✅ |",
+        "| 23 | 任务派工工时限制 | 项目任务 | afterUpsert | ✅ |",
+        "| 24 | 测试 AI 代码生成 | 客户 | beforeInsert | ❌ |",
+        "| 25 | 验证审批时校验预算 | 费用报销 | approval | ❌ |",
+        "",
+        "文档生成时间：2026-03-24",
+        "基于 CloudCC 生产环境 25 个触发器实例分析",
         "",
     ];
 

package/src/triggers/pullList.js

@@ -1,3 +1,6 @@
+
+
+
 const fs = require("fs");
 const path = require("path")
 const { getPackageJson } = require("../../utils/config");

package/target/maven-archiver/pom.properties

@@ -0,0 +1,3 @@
+artifactId=ccopenapi
+groupId=com.cloudcc.core
+version=0.0.4

package/target/maven-status/maven-compiler-plugin/compile/default-compile/createdFiles.lst

@@ -0,0 +1,20 @@
+com/cloudcc/core/CCObject.class
+com/cloudcc/core/TriggerTimeEnum.class
+com/cloudcc/core/UserInfo.class
+com/cloudcc/core/SendEmail.class
+com/cloudcc/core/BusiException.class
+com/cloudcc/core/PeakInterf.class
+com/cloudcc/core/TimeUtil.class
+com/cloudcc/core/CCTriggerHandler.class
+com/cloudcc/core/Tool.class
+com/cloudcc/core/TriggerInvoker.class
+com/cloudcc/core/CCSchedule.class
+com/cloudcc/core/BaseException.class
+com/cloudcc/core/OperatationEnum.class
+com/cloudcc/core/TriggerMethod.class
+com/cloudcc/core/ServiceResult.class
+com/cloudcc/core/StringUtils.class
+com/cloudcc/core/DevLogger.class
+com/cloudcc/core/CCService.class
+com/cloudcc/core/CCTrigger.class
+com/cloudcc/core/Tool$1.class

package/target/maven-status/maven-compiler-plugin/compile/default-compile/inputFiles.lst

@@ -0,0 +1,19 @@
+/Users/xuhm/Documents/cloudcc-cli/java/com/cloudcc/core/ServiceResult.java
+/Users/xuhm/Documents/cloudcc-cli/java/com/cloudcc/core/TriggerInvoker.java
+/Users/xuhm/Documents/cloudcc-cli/java/com/cloudcc/core/UserInfo.java
+/Users/xuhm/Documents/cloudcc-cli/java/com/cloudcc/core/Tool.java
+/Users/xuhm/Documents/cloudcc-cli/java/com/cloudcc/core/CCService.java
+/Users/xuhm/Documents/cloudcc-cli/java/com/cloudcc/core/CCSchedule.java
+/Users/xuhm/Documents/cloudcc-cli/java/com/cloudcc/core/SendEmail.java
+/Users/xuhm/Documents/cloudcc-cli/java/com/cloudcc/core/OperatationEnum.java
+/Users/xuhm/Documents/cloudcc-cli/java/com/cloudcc/core/BaseException.java
+/Users/xuhm/Documents/cloudcc-cli/java/com/cloudcc/core/CCTriggerHandler.java
+/Users/xuhm/Documents/cloudcc-cli/java/com/cloudcc/core/TriggerMethod.java
+/Users/xuhm/Documents/cloudcc-cli/java/com/cloudcc/core/TriggerTimeEnum.java
+/Users/xuhm/Documents/cloudcc-cli/java/com/cloudcc/core/CCTrigger.java
+/Users/xuhm/Documents/cloudcc-cli/java/com/cloudcc/core/StringUtils.java
+/Users/xuhm/Documents/cloudcc-cli/java/com/cloudcc/core/BusiException.java
+/Users/xuhm/Documents/cloudcc-cli/java/com/cloudcc/core/DevLogger.java
+/Users/xuhm/Documents/cloudcc-cli/java/com/cloudcc/core/PeakInterf.java
+/Users/xuhm/Documents/cloudcc-cli/java/com/cloudcc/core/TimeUtil.java
+/Users/xuhm/Documents/cloudcc-cli/java/com/cloudcc/core/CCObject.java