@agile-team/wl-skills-kit 2.1.2 → 2.1.3

package/files/.github/standards/index.md

@@ -1,89 +1,89 @@
-# Standards 规范门控（懒加载入口）
-
-> **版本**：v1.0.0 **维护者**：CHENY (工号 409322)
-> **加载策略**：AI 按当前任务类型，**只读取相关条目**，不全量加载。
-
----
-
-## 13 条规范清单
-
-| 编号 | 文件                        | 主题                   | 强制度         |
-| ---- | --------------------------- | ---------------------- | -------------- |
-| 01   | `01-toolchain.md`           | 工具链前置检测         | 🔴 阻断        |
-| 02   | `02-code-structure.md`      | 代码结构与顺序         | 🔴 必遵        |
-| 03   | `03-comments.md`            | 注释规范               | 🟡 建议        |
-| 04   | `04-coding-basics.md`       | 基础编码（13 条）      | 🔴 必遵        |
-| 05   | `05-logging.md`             | 日志输出               | 🔴 必遵        |
-| 06   | `06-security.md`            | 安全规范               | 🔴 必遵        |
-| 07   | `07-config.md`              | 配置管理               | 🔴 必遵        |
-| 08   | `08-git.md`                 | Git 分支 & 提交        | 🔴 必遵        |
-| 09   | `09-typescript.md`          | TypeScript 类型        | 🟡 建议        |
-| 10   | `10-pinia.md`               | Pinia 状态管理         | 🔴 必遵        |
-| 11   | `11-form-validation.md`     | 表单与校验             | 🔴 必遵        |
-| 12   | `12-base-table.md`          | BaseTable + AGGrid cid | 🔴 必遵        |
-| 13   | `13-platform-components.md` | 平台组件合规（核心）   | 🔴 必遵 + 阻断 |
-
----
-
-## 任务类型 → 必读规范映射
-
-> AI 按用户意图选取下方匹配的「任务类型」，**仅加载该类型对应的规范文件**。
-
-### 任务类型 A：生成新页面（page-codegen）
-
-```
-必读：01 / 02 / 04 / 12 / 13
-按需：09（TS 类型复杂时） / 10（涉及 Store） / 11（FORM_ROUTE 模板）
-```
-
-### 任务类型 B：修改/重构既有页面
-
-```
-必读：02 / 04 / 13
-按需：09 / 10 / 11
-```
-
-### 任务类型 C：规范审计（convention-audit）
-
-```
-必读：全部 13 条（审计需要完整对照）
-```
-
-### 任务类型 D：模板提取（template-extract）
-
-```
-必读：02 / 13（模板必须遵循结构与组件合规规则）
-```
-
-### 任务类型 E：菜单/字典/权限同步类
-
-```
-必读：07（环境变量与 API 地址不硬编码）
-```
-
-### 任务类型 F：仅 Git 操作 / Commit
-
-```
-必读：08
-```
-
----
-
-## 加载方式（Pre-flight 声明示例）
-
-```
-✅ 已读取 standards/index.md            → 规范门控，匹配任务类型 A（生成新页面）
-✅ 已读取 standards/02-code-structure.md → 4 文件原则 + 三段式 + script 9 段顺序
-✅ 已读取 standards/12-base-table.md     → AGGrid 必用 + cid 命名规范
-✅ 已读取 standards/13-platform-components.md → 平台组件对照表
-```
-
-> **不要** 一次性读取全部 13 条。错误示范：`✅ 已读取 standards/01 ~ standards/13`（浪费 token，违反懒加载原则）。
-
----
-
-## 规范变更管理
-
-- 新增规范条目：编号顺序追加，不复用废弃编号
-- 修改既有规范：在文件末尾追加 `## 变更记录` 章节，登记日期 + 变更摘要
-- 整体破坏性变更：升级本文件顶部 `version`，并在根 `CHANGELOG.md` 标注
+# Standards 规范门控（懒加载入口）
+
+> **版本**：v1.0.0 **维护者**：CHENY (工号 409322)
+> **加载策略**：AI 按当前任务类型，**只读取相关条目**，不全量加载。
+
+---
+
+## 13 条规范清单
+
+| 编号 | 文件                        | 主题                   | 强制度         |
+| ---- | --------------------------- | ---------------------- | -------------- |
+| 01   | `01-toolchain.md`           | 工具链前置检测         | 🔴 阻断        |
+| 02   | `02-code-structure.md`      | 代码结构与顺序         | 🔴 必遵        |
+| 03   | `03-comments.md`            | 注释规范               | 🟡 建议        |
+| 04   | `04-coding-basics.md`       | 基础编码（13 条）      | 🔴 必遵        |
+| 05   | `05-logging.md`             | 日志输出               | 🔴 必遵        |
+| 06   | `06-security.md`            | 安全规范               | 🔴 必遵        |
+| 07   | `07-config.md`              | 配置管理               | 🔴 必遵        |
+| 08   | `08-git.md`                 | Git 分支 & 提交        | 🔴 必遵        |
+| 09   | `09-typescript.md`          | TypeScript 类型        | 🟡 建议        |
+| 10   | `10-pinia.md`               | Pinia 状态管理         | 🔴 必遵        |
+| 11   | `11-form-validation.md`     | 表单与校验             | 🔴 必遵        |
+| 12   | `12-base-table.md`          | BaseTable + AGGrid cid | 🔴 必遵        |
+| 13   | `13-platform-components.md` | 平台组件合规（核心）   | 🔴 必遵 + 阻断 |
+
+---
+
+## 任务类型 → 必读规范映射
+
+> AI 按用户意图选取下方匹配的「任务类型」，**仅加载该类型对应的规范文件**。
+
+### 任务类型 A：生成新页面（page-codegen）
+
+```
+必读：01 / 02 / 04 / 12 / 13
+按需：09（TS 类型复杂时） / 10（涉及 Store） / 11（FORM_ROUTE 模板）
+```
+
+### 任务类型 B：修改/重构既有页面
+
+```
+必读：02 / 04 / 13
+按需：09 / 10 / 11
+```
+
+### 任务类型 C：规范审计（convention-audit）
+
+```
+必读：全部 13 条（审计需要完整对照）
+```
+
+### 任务类型 D：模板提取（template-extract）
+
+```
+必读：02 / 13（模板必须遵循结构与组件合规规则）
+```
+
+### 任务类型 E：菜单/字典/权限同步类
+
+```
+必读：07（环境变量与 API 地址不硬编码）
+```
+
+### 任务类型 F：仅 Git 操作 / Commit
+
+```
+必读：08
+```
+
+---
+
+## 加载方式（Pre-flight 声明示例）
+
+```
+✅ 已读取 standards/index.md            → 规范门控，匹配任务类型 A（生成新页面）
+✅ 已读取 standards/02-code-structure.md → 4 文件原则 + 三段式 + script 9 段顺序
+✅ 已读取 standards/12-base-table.md     → AGGrid 必用 + cid 命名规范
+✅ 已读取 standards/13-platform-components.md → 平台组件对照表
+```
+
+> **不要** 一次性读取全部 13 条。错误示范：`✅ 已读取 standards/01 ~ standards/13`（浪费 token，违反懒加载原则）。
+
+---
+
+## 规范变更管理
+
+- 新增规范条目：编号顺序追加，不复用废弃编号
+- 修改既有规范：在文件末尾追加 `## 变更记录` 章节，登记日期 + 变更摘要
+- 整体破坏性变更：升级本文件顶部 `version`，并在根 `CHANGELOG.md` 标注

package/files/demo/produce/aiflow/mmwr-customer-apply-change-history/data.ts

@@ -1,196 +1,196 @@
-import { getAction } from "@jhlc/common-core/src/api/action";
-import { useRouter } from "vue-router";
-import { createChangeMockData } from "@/components/local/c_customerTabs/data";
-import type {
-  BasicInfoForm,
-  BusinessInfoRow
-} from "@/components/local/c_customerTabs/data";
-
-export const API_CONFIG = {
-  changeHistoryList: "/sale/customerApply/changeHistory/list",
-  getById: "/sale/customerApply/changeHistory/getById",
-  getDiffById: "/sale/customerApply/changeHistory/getDiffById"
-} as const;
-
-export interface HistoryRecord {
-  id: string;
-  changeType: string;
-  changeTime: string;
-  changePerson: string;
-}
-
-/** 变更历史记录 mock 数据（对齐原型截图，首条为"数据变更"以便立即展示比对效果） */
-function createHistoryListMock(): HistoryRecord[] {
-  return [
-    {
-      id: "h001",
-      changeType: "数据变更",
-      changeTime: "2025/12/15 13:48:07",
-      changePerson: "变更人姓名"
-    },
-    {
-      id: "h002",
-      changeType: "数据新增",
-      changeTime: "2025/12/15 13:48:07",
-      changePerson: "新增人姓名"
-    },
-    {
-      id: "h003",
-      changeType: "数据新增",
-      changeTime: "2025/12/15 13:48:07",
-      changePerson: "新增人姓名"
-    },
-    {
-      id: "h004",
-      changeType: "数据变更",
-      changeTime: "2025/12/15 13:48:07",
-      changePerson: "变更人姓名"
-    },
-    {
-      id: "h005",
-      changeType: "数据变更",
-      changeTime: "2025/12/15 13:48:07",
-      changePerson: "变更人姓名"
-    },
-    {
-      id: "h006",
-      changeType: "数据新增",
-      changeTime: "2025/12/15 13:48:07",
-      changePerson: "新增人姓名"
-    },
-    {
-      id: "h007",
-      changeType: "数据新增",
-      changeTime: "2025/12/15 13:48:07",
-      changePerson: "新增人姓名"
-    }
-  ];
-}
-
-/** 变更比对 mock：旧版数据（对齐原型截图中的上下比对效果）
- *  使用显示标签（非值码），以便 diff-old-value 直接展示中文。
- *  - basicInfo.taxCategory:   "小规模纳税人"（旧）vs "一级纳税人"（新）
- *  - basicInfo.relationType:  "02-合并关系人"（旧）vs "03-非关系人"（新）
- *  - businessInfoList[0]:     salesType "外销"（旧）vs "内销"（新），customerLevel "B3" vs "B1"
- */
-function createDiffMockData(): {
-  basicInfo: BasicInfoForm;
-  businessInfoList: BusinessInfoRow[];
-} {
-  const current = createChangeMockData();
-  return {
-    basicInfo: {
-      ...current.basicInfo,
-      taxCategory: "小规模纳税人",
-      relationType: "02-合并关系人"
-    },
-    businessInfoList: current.businessInfoList.map((row, idx) => {
-      if (idx === 0) {
-        return { ...row, salesType: "外销", customerLevel: "B3" };
-      }
-      return { ...row };
-    })
-  };
-}
-
-export function useChangeHistory(tabsRef: any) {
-  const router = useRouter();
-  const loading = ref(false);
-  const historyLoading = ref(false);
-  const historyList = ref<HistoryRecord[]>([]);
-  const selectedId = ref<string>("");
-  const isMockMode = ref(false);
-
-  // ─── 真实接口模式（有 id 时调用） ───
-
-  async function loadHistoryList(applyId: string) {
-    isMockMode.value = false;
-    historyLoading.value = true;
-    try {
-      const res = await getAction(API_CONFIG.changeHistoryList, { applyId });
-      if (res?.data?.length) {
-        historyList.value = res.data;
-      }
-    } finally {
-      historyLoading.value = false;
-      if (historyList.value.length > 0) {
-        await loadHistoryDetail(historyList.value[0].id);
-      }
-    }
-  }
-
-  async function loadHistoryDetail(id: string) {
-    selectedId.value = id;
-    loading.value = true;
-    const currentRecord = historyList.value.find((r) => r.id === id);
-    const isChangeType = currentRecord?.changeType.includes("变更");
-    try {
-      const res = await getAction(API_CONFIG.getById, { id });
-      if (res?.data) {
-        tabsRef.value?.loadData(res.data);
-        if (isChangeType) {
-          const diffRes = await getAction(API_CONFIG.getDiffById, { id }).catch(
-            () => null
-          );
-          if (diffRes?.data) {
-            tabsRef.value?.loadDiffData(diffRes.data);
-          } else {
-            tabsRef.value?.clearDiffData?.();
-          }
-        } else {
-          tabsRef.value?.clearDiffData?.();
-        }
-      }
-    } finally {
-      loading.value = false;
-    }
-  }
-
-  // ─── Mock 模式（无 id 时调用，纯本地数据，零接口请求） ───
-
-  function loadMockData() {
-    isMockMode.value = true;
-    historyList.value = createHistoryListMock();
-    if (historyList.value.length > 0) {
-      nextTick(() => selectMockDetail(historyList.value[0].id));
-    }
-  }
-
-  function selectMockDetail(id: string) {
-    selectedId.value = id;
-    const currentRecord = historyList.value.find((r) => r.id === id);
-    const isChangeType = currentRecord?.changeType.includes("变更");
-    tabsRef.value?.loadData(createChangeMockData());
-    if (isChangeType) {
-      tabsRef.value?.loadDiffData(createDiffMockData());
-    } else {
-      tabsRef.value?.clearDiffData?.();
-    }
-  }
-
-  // ─── 公共 ───
-
-  function handleSelectHistory(item: HistoryRecord) {
-    if (item.id === selectedId.value) return;
-    if (isMockMode.value) {
-      selectMockDetail(item.id);
-    } else {
-      loadHistoryDetail(item.id);
-    }
-  }
-
-  function handleCancel() {
-    router.back();
-  }
-
-  return {
-    loading,
-    historyLoading,
-    historyList,
-    selectedId,
-    loadHistoryList,
-    loadMockData,
-    handleSelectHistory,
-    handleCancel
-  };
-}
+import { getAction } from "@jhlc/common-core/src/api/action";
+import { useRouter } from "vue-router";
+import { createChangeMockData } from "@/components/local/c_customerTabs/data";
+import type {
+  BasicInfoForm,
+  BusinessInfoRow
+} from "@/components/local/c_customerTabs/data";
+
+export const API_CONFIG = {
+  changeHistoryList: "/sale/customerApply/changeHistory/list",
+  getById: "/sale/customerApply/changeHistory/getById",
+  getDiffById: "/sale/customerApply/changeHistory/getDiffById"
+} as const;
+
+export interface HistoryRecord {
+  id: string;
+  changeType: string;
+  changeTime: string;
+  changePerson: string;
+}
+
+/** 变更历史记录 mock 数据（对齐原型截图，首条为"数据变更"以便立即展示比对效果） */
+function createHistoryListMock(): HistoryRecord[] {
+  return [
+    {
+      id: "h001",
+      changeType: "数据变更",
+      changeTime: "2025/12/15 13:48:07",
+      changePerson: "变更人姓名"
+    },
+    {
+      id: "h002",
+      changeType: "数据新增",
+      changeTime: "2025/12/15 13:48:07",
+      changePerson: "新增人姓名"
+    },
+    {
+      id: "h003",
+      changeType: "数据新增",
+      changeTime: "2025/12/15 13:48:07",
+      changePerson: "新增人姓名"
+    },
+    {
+      id: "h004",
+      changeType: "数据变更",
+      changeTime: "2025/12/15 13:48:07",
+      changePerson: "变更人姓名"
+    },
+    {
+      id: "h005",
+      changeType: "数据变更",
+      changeTime: "2025/12/15 13:48:07",
+      changePerson: "变更人姓名"
+    },
+    {
+      id: "h006",
+      changeType: "数据新增",
+      changeTime: "2025/12/15 13:48:07",
+      changePerson: "新增人姓名"
+    },
+    {
+      id: "h007",
+      changeType: "数据新增",
+      changeTime: "2025/12/15 13:48:07",
+      changePerson: "新增人姓名"
+    }
+  ];
+}
+
+/** 变更比对 mock：旧版数据（对齐原型截图中的上下比对效果）
+ *  使用显示标签（非值码），以便 diff-old-value 直接展示中文。
+ *  - basicInfo.taxCategory:   "小规模纳税人"（旧）vs "一级纳税人"（新）
+ *  - basicInfo.relationType:  "02-合并关系人"（旧）vs "03-非关系人"（新）
+ *  - businessInfoList[0]:     salesType "外销"（旧）vs "内销"（新），customerLevel "B3" vs "B1"
+ */
+function createDiffMockData(): {
+  basicInfo: BasicInfoForm;
+  businessInfoList: BusinessInfoRow[];
+} {
+  const current = createChangeMockData();
+  return {
+    basicInfo: {
+      ...current.basicInfo,
+      taxCategory: "小规模纳税人",
+      relationType: "02-合并关系人"
+    },
+    businessInfoList: current.businessInfoList.map((row, idx) => {
+      if (idx === 0) {
+        return { ...row, salesType: "外销", customerLevel: "B3" };
+      }
+      return { ...row };
+    })
+  };
+}
+
+export function useChangeHistory(tabsRef: any) {
+  const router = useRouter();
+  const loading = ref(false);
+  const historyLoading = ref(false);
+  const historyList = ref<HistoryRecord[]>([]);
+  const selectedId = ref<string>("");
+  const isMockMode = ref(false);
+
+  // ─── 真实接口模式（有 id 时调用） ───
+
+  async function loadHistoryList(applyId: string) {
+    isMockMode.value = false;
+    historyLoading.value = true;
+    try {
+      const res = await getAction(API_CONFIG.changeHistoryList, { applyId });
+      if (res?.data?.length) {
+        historyList.value = res.data;
+      }
+    } finally {
+      historyLoading.value = false;
+      if (historyList.value.length > 0) {
+        await loadHistoryDetail(historyList.value[0].id);
+      }
+    }
+  }
+
+  async function loadHistoryDetail(id: string) {
+    selectedId.value = id;
+    loading.value = true;
+    const currentRecord = historyList.value.find((r) => r.id === id);
+    const isChangeType = currentRecord?.changeType.includes("变更");
+    try {
+      const res = await getAction(API_CONFIG.getById, { id });
+      if (res?.data) {
+        tabsRef.value?.loadData(res.data);
+        if (isChangeType) {
+          const diffRes = await getAction(API_CONFIG.getDiffById, { id }).catch(
+            () => null
+          );
+          if (diffRes?.data) {
+            tabsRef.value?.loadDiffData(diffRes.data);
+          } else {
+            tabsRef.value?.clearDiffData?.();
+          }
+        } else {
+          tabsRef.value?.clearDiffData?.();
+        }
+      }
+    } finally {
+      loading.value = false;
+    }
+  }
+
+  // ─── Mock 模式（无 id 时调用，纯本地数据，零接口请求） ───
+
+  function loadMockData() {
+    isMockMode.value = true;
+    historyList.value = createHistoryListMock();
+    if (historyList.value.length > 0) {
+      nextTick(() => selectMockDetail(historyList.value[0].id));
+    }
+  }
+
+  function selectMockDetail(id: string) {
+    selectedId.value = id;
+    const currentRecord = historyList.value.find((r) => r.id === id);
+    const isChangeType = currentRecord?.changeType.includes("变更");
+    tabsRef.value?.loadData(createChangeMockData());
+    if (isChangeType) {
+      tabsRef.value?.loadDiffData(createDiffMockData());
+    } else {
+      tabsRef.value?.clearDiffData?.();
+    }
+  }
+
+  // ─── 公共 ───
+
+  function handleSelectHistory(item: HistoryRecord) {
+    if (item.id === selectedId.value) return;
+    if (isMockMode.value) {
+      selectMockDetail(item.id);
+    } else {
+      loadHistoryDetail(item.id);
+    }
+  }
+
+  function handleCancel() {
+    router.back();
+  }
+
+  return {
+    loading,
+    historyLoading,
+    historyList,
+    selectedId,
+    loadHistoryList,
+    loadMockData,
+    handleSelectHistory,
+    handleCancel
+  };
+}