@alanwang-merit/meritdata-platform-skill-package 1.0.10 → 1.0.11

package/rules/meritdata-platform-data-boundary.md

@@ -1,183 +0,0 @@
-<!--
-来源：全局 ~/.claude/rules/meritdata-platform-data-boundary.md v1.0（2026-04 起累计）
-下放到套件：2026-09-09（v2.6.3）
-后续治理：套件内自包含权威版本；全局版可作为兜底但优先以本文件为准
--->
-
-# MeritData 数据边界硬规则（所有 MeritData 项目自动生效）
-
-**触发条件**：任何 MeritData Cloud 二开项目的数据访问代码生成前、PR 提交前、CI 扫描时。
-
-**配套操作指南**：`meritdata-platform-data-access` skill（按需触发）—— 本文件只定义"什么不能做"，skill 定义"怎么做"。
-
----
-
-## §1 4 条铁律（强制，违反即阻断）
-
-### 1.1 不映射 PF_ 前缀平台表
-
-**禁止**：二开业务库 `@TableName("PF_USER")` / `CREATE TABLE PF_xxx` / 跨库 JOIN 任何 PF_ 表。
-
-**理由**：PF_ 是平台专属表前缀，跨库访问导致数据库耦合、平台升级失败、并发压力转嫁。
-
-**唯一例外**：同 JVM 平台模块内的代码（详见 skill 的 `references/same-jvm.md`）。
-
-### 1.2 不分页循环逐条 Feign
-
-**禁止**：
-
-```java
-for (int page = 1; page <= totalPages; page++) {
-    List<MyData> dataList = myRepo.findPage(page);
-    for (MyData data : dataList) {
-        UserDTO user = userClient.getById(data.getUserId());  // N 次 Feign = N+1
-    }
-}
-```
-
-**正确模式**（详见 skill）：一次 Feign 批量拉取 + 内存 join。
-
-### 1.3 不复制平台 Entity/Repository
-
-**禁止**：`import com.meritdata.cloud.platform.entity.*` 出现在二开业务代码中（独立部署场景）。
-
-**正确模式**：通过 DTO 转换；独立服务通过 Feign Client 接收 DTO。
-
-### 1.4 不掩盖平台故障
-
-**禁止**：`catch (Exception e) { return Collections.emptyList(); }` 吃掉 Feign 失败。
-
-**正确模式**：显式上抛异常，让上游感知平台故障。
-
----
-
-## §2 触发场景（本规则自动生效的场景）
-
-| 场景 | 是否触发本规则 |
-|------|--------------|
-| 二开库的数据访问代码生成 | ✅ 触发 |
-| 二开服务的 Controller/Service/Repository 文件修改 | ✅ 触发 |
-| Feign Client 代码生成 | ✅ 触发 |
-| 平台模块（与平台同 JVM）的代码修改 | ❌ 不触发（参考 `meritdata-platform-entities`）|
-| 前端代码生成 | ❌ 不触发（不涉及数据库）|
-| 文档生成 | ❌ 不触发 |
-
----
-
-## §3 CI 校验命令（项目级可执行）
-
-### 3.1 检测 PF_ 表映射
-
-```bash
-grep -r 'PF_[A-Z]' src/main/java/ \
-  && echo "❌ 发现 PF_ 前缀引用，违反铁律 1.1" \
-  && exit 1 \
-  || echo "✅ 未发现 PF_ 引用"
-```
-
-### 3.2 检测跨库 JOIN
-
-```bash
-grep -rE 'JOIN\s+PF_' src/main/resources/mapper/ \
-  && echo "❌ 发现跨库 JOIN 平台表，违反铁律 1.1" \
-  && exit 1 \
-  || echo "✅ 未发现跨库 JOIN"
-```
-
-### 3.3 检测平台 Entity 直接 import
-
-```bash
-grep -r 'import com.meritdata.cloud.platform.entity' src/main/java/com/example/ \
-  && echo "❌ 二开项目不应直接 import 平台 Entity，违反铁律 1.3" \
-  && exit 1 \
-  || echo "✅ 未发现平台 Entity 直接引用"
-```
-
-### 3.4 检测空集合掩盖异常
-
-```bash
-grep -rn 'catch.*Exception.*emptyList\|catch.*Exception.*Collections.empty' src/main/java/ \
-  | grep -v 'test/' \
-  && echo "⚠️ 疑似空集合掩盖异常，请人工 review 是否违反铁律 1.4" \
-  || echo "✅ 未发现空集合掩盖模式"
-```
-
-完整脚本（含反模式库）见配套 skill 的 `references/validate-rules.md`。
-
----
-
-## §4 配套 skill 与文档
-
-| 类别 | 入口 | 内容 |
-|------|------|------|
-| **硬约束**（本文件） | `~/.claude/rules/meritdata-platform-data-boundary.md` | 4 条铁律 + 触发场景 + CI 命令 |
-| **操作指南**（按需触发）| `meritdata-platform-data-access` skill | Feign 批量装配模式、同 JVM 判定、平台表清单 |
-| **平台表清单** | skill `references/cloud-tables.md` | 所有 PF_ 前缀表及对应 Feign/API |
-| **CI 脚本完整版** | skill `references/validate-rules.md` | 完整反模式检测脚本 |
-| **跨 skill 编排** | `meritdata-platform-playbook` | 综合需求时由 playbook 路由 |
-
----
-
-## §5 反模式 vs 正模式速查
-
-| 反模式 | 正模式 | 触发铁律 |
-|--------|--------|---------|
-| `@TableName("PF_USER")` | `userClient.listByIds(...)` | 1.1 |
-| `for循环 + userClient.getById` | `userClient.listByIds(去重 ID 集合)` | 1.2 |
-| `import 平台 Entity` | 通过 DTO 转换 | 1.3 |
-| `catch + return emptyList` | `throw new ServiceException(...)` | 1.4 |
-| `select * from user u join order o ...` 跨库 | 业务数据本地 + 用户 Feign 批量 | 1.1 |
-
----
-
-## §6 例外与豁免
-
-### 6.1 同 JVM 例外
-
-当二开代码与平台模块部署在**同一个 JVM 进程**且**明确引入 cloud-system-manage-module** 时，可直接使用平台本地 Bean（如 `IDamService`）。
-
-**判定方法**：详见 skill 的 `references/same-jvm.md`。
-
-**注意**：即使是同 JVM，**仍禁止**：
-- 直连平台数据库
-- 复制平台 Entity 到二开库
-- 跨库 JOIN
-
-### 6.2 测试代码豁免
-
-测试代码（`src/test/`）不受铁律 1.4（空集合掩盖）限制，可使用 mock 数据。
-
-### 6.3 历史项目兼容
-
-存量 5.x 旧版项目允许保留旧数据访问模式，但**新增代码必须遵守本规则**。
-
----
-
-## §7 违规处置
-
-| 等级 | 触发条件 | 处置 |
-|------|---------|------|
-| 🔴 阻断 | 铁律 1.1 / 1.2 / 1.3 / 1.4 任一违反 | PR 拒绝合并；CI 失败 |
-| 🟠 警告 | 疑似反模式（如 §3.4 检测）| 人工 review；不阻断 |
-| 🟢 提示 | 不涉及数据访问的代码 | 不触发 |
-
----
-
-## §8 与全局规则的关系
-
-| 现有 rule | 关系 |
-|----------|------|
-| `~/.claude/rules/code-dev-rules.md` | 本规则是其"数据访问"专项细化；通用编码规范仍由 code-dev-rules 管辖 |
-| `~/.claude/rules/security-rules.md` | 本规则涉及"敏感数据访问"的部分与 security-rules 协同 |
-| `~/.claude/rules/performance-rules.md` | 本规则 1.2（不分页循环 Feign）实质是 performance-rules 的"数据库性能"专项 |
-
-**优先级**：当本规则与其他 rule 冲突时，以本规则为准（专项规则优先于通用规则）。
-
----
-
-## §9 版本与变更
-
-- v1.0（2026-09-04）：初版，从 `meritdata-platform-data-boundary` skill 的 4 条铁律 + 触发场景 + CI 命令抽取
-- 来源：原 `core/meritdata-platform-data-boundary/SKILL.md` §MUST DO + §触发条件 + §代码示例
-
-后续变更通过 PR review，重大变更需架构组确认。

package/rules/meritdata-platform-domain-model-rules.md

@@ -1,248 +0,0 @@
-<!--
-来源：全局 ~/.claude/rules/meritdata-platform-domain-model-rules.md v1.0（2026-04 起累计）
-下放到套件：2026-09-09（v2.6.3）
-后续治理：套件内自包含权威版本；全局版可作为兜底但优先以本文件为准
--->
-
-# MeritData 业务建模硬规则（所有 MeritData 项目自动生效）
-
-**触发条件**：任何 MeritData Cloud 二开项目进行业务建模、数据库表设计、实体类生成前、PR 提交前。
-
-**配套操作指南**：`meritdata-platform-domain-model` skill（按需触发）—— 本文件只定义"什么不能做"和"必须怎么做"，skill 定义"怎么思考"。
-
----
-
-## §1 表命名硬规则（强制，违反即阻断）
-
-### 1.1 二开业务表/字段必须小写蛇形
-
-**必须**：
-- 表名：`t_purchase_order`、`t_order_item`（小写蛇形，以 `t_` 开头）
-- 字段名：`order_no`、`create_by`、`create_time`（小写蛇形）
-- 索引名：`idx_t_purchase_order_user_id`、`uk_t_purchase_order_no`
-
-**禁止**：
-- 大写或驼峰：`PurchaseOrder`、`purchaseOrder`、`orderNo`
-- 沿用平台 `PF_` 前缀：`PF_USER`、`PF_LEGACY_ORDER`（详见 `meritdata-platform-data-boundary.md` §1.1）
-
-**实体类命名（与表命名解耦）**：
-- Java 实体类：**大驼峰**（PascalCase）—— `PurchaseOrder`、`OrderItem`
-- 字段：`orderNo`、`createBy`（驼峰）
-- 通过 `@Column("order_no")` 显式映射到小写蛇形字段
-
-### 1.2 历史/特殊主表可申请例外
-
-**例外流程**（必须同时满足）：
-1. 显式声明例外开关（如 `@TableName(value = "LEGACY_ORDER", excludeProperty = {...})`）
-2. 注明"不可改名原因"（对接上游老系统 / 监管要求 / 数据迁移约束）
-3. 新业务列、关联表**不随主表例外放宽**——仍按 §1.1 走小写蛇形
-
-**反例**：因主表叫 `T_LEGACY_ORDER`，就给新加的 `T_LEGACY_ORDER_DETAIL` 也用大写 → 禁止。
-
----
-
-## §2 关联键硬规则（强制，违反即阻断）
-
-### 2.1 不得把人员、组织名称作为唯一关联键
-
-**禁止**：
-```sql
--- ❌ 用姓名/组织名做关联
-WHERE t_order.applicant_name = '张三' AND t_order.dept_name = '采购部'
-```
-
-**必须**：
-```sql
--- ✅ 用稳定 ID 做关联
-WHERE t_order.applicant_user_id = '10001' AND t_order.dept_id = 'D001'
-```
-
-**理由**：人员/组织名称会变更（重名、调动、合并），ID 才是稳定键。
-
-**配套**：名称作为**冗余字段**快照存储（如 `applicant_name_snapshot`），用于显示。
-
-### 2.2 跨服务禁止数据库外键
-
-**禁止**：
-```sql
--- ❌ 二开服务 A 创建外键指向二开服务 B 的表
-ALTER TABLE t_order_a ADD CONSTRAINT fk_order_user FOREIGN KEY (user_id) REFERENCES service_b.t_user(id);
-```
-
-**必须**：跨服务通过应用层维护一致性（ID 引用 + 应用服务编排），数据库不加外键。
-
-**理由**：
-- 服务拆分要求数据自治
-- 跨服务外键导致级联删除/更新跨网络，事务无法保证
-- 部署独立化失败
-
----
-
-## §3 平台语义硬规则（强制）
-
-### 3.1 平台字段类型与存储约束
-
-| 语义 | 字段命名 | UI 组件 | 服务路由 |
-|------|---------|---------|---------|
-| 人员 | `*_user_id`（必要时快照姓名） | `meritdata-platform-ui-components` 人员弹框 | Feign 批量装配（详见 `meritdata-platform-data-access`） |
-| 组织/部门 | `*_org_id` / `*_dept_id` | 部门/组织树组件 | 同上 |
-| 角色 | `*_role_id` / `*_role_code` | 角色选择组件 | `IAssignService` |
-| 字典 | `*_type` / `*_status`（稳定 code） | `ILookupService` + 字典选择器 | Feign 批量装配 |
-| 附件 | 业务附件关联表（不把二进制放主表） | 平台上传组件 | `meritdata-platform-impexp` |
-| 审批状态 | 业务状态与流程实例 ID 分离 | — | `meritdata-platform-bpm` |
-
-**禁止**：
-- 把人员/组织名称当主键（已在 §2.1）
-- 附件二进制直接存业务表
-- 业务状态与流程实例 ID 混用
-
-### 3.2 二开库 JOIN 平台表（已在 data-boundary 拦截）
-
-**禁止**：二开库任何 SQL/JPA 跨库 JOIN cloud 平台表（`PF_` 前缀）。
-
-**详见**：`~/.claude/rules/meritdata-platform-data-boundary.md` §1.1
-
----
-
-## §4 软删除实体硬规则（与 data-boundary 联动）
-
-### 4.1 唯一性校验必须穿透软删除
-
-详见：`~/.claude/rules/code-dev-rules.md` §八（在 data-boundary §1.1 之后强制）。
-
-**禁止**：
-```java
-// ❌ JPQL 受 @Where 过滤，看不到软删除记录 → 校验放行 → INSERT 触发 SQLIntegrityConstraintViolationException
-if (repo.findByXxxNo(no).isPresent()) throw new XxxNoDuplicateException();
-```
-
-**必须**：
-```java
-// ✅ nativeQuery = true 的 findXxxIncludingDeleted 穿透 @Where
-if (repo.findXxxIncludingDeleted(no).isPresent()) throw new XxxNoDuplicateException();
-```
-
----
-
-## §5 触发场景（本规则自动生效）
-
-| 场景 | 是否触发本规则 |
-|------|--------------|
-| 新建二开业务的数据库表 | ✅ 触发 |
-| 修改已有二开业务表的字段名 | ✅ 触发 |
-| 编写 JPA 实体类 / MyBatis Mapper | ✅ 触发 |
-| 跨服务接口契约设计 | ✅ 触发（§2.2） |
-| 涉及平台人员/组织/角色/字典字段 | ✅ 触发（§3.1）|
-| Code Review / PR 评审 | ✅ 触发 |
-
----
-
-## §6 配套 skill 与文档
-
-| 类别 | 入口 | 内容 |
-|------|------|------|
-| **硬约束（本文件）** | `~/.claude/rules/meritdata-platform-domain-model-rules.md` | 5 节硬规则 + 触发场景 |
-| **操作指南** | `meritdata-platform-domain-model` skill | 业务建模方法论、聚合根设计、QueryDSL 联表 |
-| **数据边界硬约束** | `~/.claude/rules/meritdata-platform-data-boundary.md` | 4 条铁律（PF_ 表、Feign 装配、平台 Entity、异常掩盖）|
-| **命名规范硬约束** | `~/.claude/rules/naming-conventions-rules.md` | Java/类/方法/包/配置命名 |
-
----
-
-## §7 反模式 vs 正模式速查
-
-| 反模式 | 正模式 | 触发章节 |
-|--------|--------|---------|
-| `CREATE TABLE T_LegacyOrder` | `CREATE TABLE t_legacy_order` | §1.1 |
-| 字段 `orderNo`（无 @Column 映射）| `@Column("order_no") private String orderNo;` | §1.1 |
-| 实体类 `t_purchase_order` | `PurchaseOrder` | §1.1 |
-| `WHERE applicant_name = '张三'` | `WHERE applicant_user_id = '10001'` | §2.1 |
-| 跨服务外键 `FOREIGN KEY ... REFERENCES service_b.t_user` | 应用层 ID 引用 + 应用服务编排 | §2.2 |
-| 主表叫 `T_LEGACY_ORDER`，新加 `T_LEGACY_ORDER_DETAIL` 也用大写 | 主表例外开关声明原因，新表/字段仍小写蛇形 | §1.2 |
-| 附件二进制存业务主表 | 业务附件关联表 + 平台上传组件 | §3.1 |
-| 业务状态与流程实例 ID 混用 | 业务状态独立字段，流程实例 ID 单独存储 | §3.1 |
-
----
-
-## §8 与全局规则的关系
-
-| 现有 rule | 关系 |
-|----------|------|
-| `~/.claude/rules/meritdata-platform-data-boundary.md` | 本规则 §3.2、§4 与之协同；data-boundary 管"什么不能做"，本规则管"命名与关联" |
-| `~/.claude/rules/code-dev-rules.md` §八 | 软删除实体唯一性校验硬规则（详见该文件） |
-| `~/.claude/rules/naming-conventions-rules.md` | 实体类大驼峰、字段驼峰（与本规则 §1.1 表字段小写蛇形互补） |
-
-**优先级**：本规则与 `meritdata-platform-data-boundary.md` 同等优先级，专项规则优先于通用规则。
-
----
-
-## §10 CI 校验命令（项目级可执行）
-
-### 10.1 检测大写表名（CREATE TABLE）
-
-```bash
-grep -rE 'CREATE TABLE [A-Z]' src/main/resources/ \
-  && echo "❌ 发现大写表名，违反 §1.1" \
-  && exit 1 \
-  || echo "✅ 未发现大写表名"
-```
-
-### 10.2 检测字段名大写驼峰（@Column 缺失）
-
-```bash
-# 检查实体类中无 @Column 注解的 private String 类型字段（驼峰疑似未映射）
-grep -rE 'private (String|Long|Integer) [a-z]+[A-Z]' src/main/java/ \
-  | grep -v '@Column' \
-  && echo "⚠️ 疑似字段未声明 @Column 映射，违反 §1.1" \
-  || echo "✅ 字段映射完整"
-```
-
-### 10.3 检测 PF_ 前缀引用
-
-```bash
-grep -rE 'CREATE TABLE PF_[A-Z]|@TableName\("PF_' src/main/ \
-  && echo "❌ 发现 PF_ 前缀引用，违反 §1.1（详见 data-boundary.md §1.1）" \
-  && exit 1 \
-  || echo "✅ 未发现 PF_ 引用"
-```
-
-### 10.4 检测姓名做关联键
-
-```bash
-# 在 WHERE/JOIN 中查找疑似姓名/组织名字段
-grep -rE 'WHERE.*(_name|_dept_name|_org_name)|ON.*\.(name|deptName|orgName)' src/main/resources/mapper/ \
-  && echo "⚠️ 疑似用姓名做关联键，请确认是否违反 §2.1（ID 关联为佳）" \
-  || echo "✅ 未发现姓名关联键"
-```
-
-### 10.5 检测跨服务数据库外键
-
-```bash
-# 检测跨服务外键（REFERENCES 指向其他 schema/service）
-grep -rE 'FOREIGN KEY.*REFERENCES.*\.(t_|service_)' src/main/resources/ \
-  | grep -v 'local_schema' \
-  && echo "❌ 发现跨服务外键，违反 §2.2" \
-  && exit 1 \
-  || echo "✅ 未发现跨服务外键"
-```
-
-### 10.6 检测实体类命名（小写实体类）
-
-```bash
-# 检查实体类类名以小写字母开头（应为大驼峰）
-grep -rE '^public class [a-z][a-zA-Z]*' src/main/java/ \
-  | grep -v 'package' \
-  && echo "❌ 发现小写实体类命名，违反 §1.1（大驼峰）" \
-  && exit 1 \
-  || echo "✅ 实体类命名符合大驼峰"
-```
-
-完整脚本（含反模式库）参考 `~/.claude/rules/meritdata-platform-data-boundary.md` §3 的模板。
-
----
-
-## §9 版本与变更
-
-- v1.0（2026-09-04）：初版，从 `themes/meritdata-platform-domain-model/references/domain-model.md` 第 24、40 行硬约束抽取
-- 来源：domain-model.md §输出契约 第 24 行 + §平台语义路由 第 40 行
-
-后续变更通过 PR review，重大变更需架构组确认。

package/rules/requirement-dev-rules.md

@@ -1,77 +0,0 @@
-<!--
-来源：全局 ~/.claude/rules/requirement-dev-rules.md v1.0（2026-04 起累计）
-下放到套件：2026-09-09（v2.6.3）
-后续治理：套件内自包含权威版本；全局版可作为兜底但优先以本文件为准
--->
-
-# 需求开发指南
-
-**触发条件**：进行需求分析、需求设计、编写PRD时
-
----
-
-## 一、需求结构
-
-**必须执行**：
-- 包含版本更新记录（版本、类型、提交人、日期、更新内容）
-- 描述业务背景，说明为什么要做这个需求
-- 定义功能范围：影响范围、业务角色、业务主流程
-- 明确业务约束、技术约束、平台约束
-
----
-
-## 二、功能定义
-
-**必须执行**：
-- 每个功能必须有明确的功能点描述
-- 说明功能的前置条件和后置条件
-- 描述输入如何转换为输出
-- 说明正常流程和异常流程
-
----
-
-## 三、非功能需求
-
-**必须执行**：
-- 定义性能需求（响应时间、并发数）
-- 定义安全性需求（认证、授权、数据加密）
-- 定义可靠性需求（可用性、故障恢复）
-- 定义扩展性需求
-
----
-
-## 四、接口设计
-
-**必须执行**：
-- 说明接口主要用途、关键输入参数、接口类型
-- 说明接口设计约束
-- 说明接口安全性需求
-- 提供调用示例
-
----
-
-## 五、兼容性 & 边界
-
-**必须执行**：
-- 说明浏览器兼容性要求
-- 说明数据库字符集要求
-- 说明JDK版本要求
-- 说明对历史功能的影响
-
----
-
-## 六、验证条件
-
-**必须执行**：
-- 每个功能必须有可测试性说明
-- 说明如何验证需求是否完成
-- 定义通过/失败的标准
-- 列出不可测试的需求并说明原因
-
----
-
-## 重要提醒
-
-- 需求必须通过技术研究验证后方可进入开发
-- 需求描述要清晰无歧义，避免"满足需求"这类模糊表述
-- 功能模块关系图要及时维护

package/rules/system-test-rules.md

@@ -1,90 +0,0 @@
-<!--
-来源：全局 ~/.claude/rules/system-test-rules.md v1.0（2026-04 起累计）
-下放到套件：2026-09-09（v2.6.3）
-后续治理：套件内自包含权威版本；全局版可作为兜底但优先以本文件为准
--->
-
-# 系统测试设计指南
-
-**触发条件**：设计系统测试、集成测试、用户验收测试时
-
----
-
-## 一、功能关联测试
-
-**必须执行**：
-- 测试存在依赖或关联的功能
-- 验证历史数据兼容性
-- 测试新功能对老功能的影响
-
----
-
-## 二、兼容性测试
-
-**必须执行**：
-- 浏览器兼容性测试（Chrome、Firefox、Edge、Safari）
-- 分辨率兼容性测试（1024x768、1920x1080等）
-- 数据库兼容性测试（不同数据库版本）
-- 集群模式测试
-
----
-
-## 三、安全测试
-
-**必须执行**：
-- 审计日志检查（操作日志完整性）
-- SQL注入检查
-- XSS注入检查
-- 敏感信息加密检查
-- 水平越权和垂直越权检查
-- 认证失败提示信息不能过于详细
-- 上传文件格式校验测试
-
----
-
-## 四、异常中断测试
-
-**必须执行**：
-- 错误操作顺序的测试
-- ESC键或停止键终止处理的测试
-- 数据传输中断连接的测试
-- 服务器宕机恢复测试
-
----
-
-## 五、非法数据测试
-
-**必须执行**：
-- 空空格、回车、空包、空数据测试
-- 连续两次相同数据测试
-- 超大文件上传测试
-- 错误格式数据测试
-
----
-
-## 六、性能 & 疲劳测试
-
-**必须执行**：
-- 性能目标与需求一致验证
-- 长时间持续运行稳定性测试
-- 最大并发数压力测试
-- 文件句柄占用测试
-- 疲劳测试（持续运行8小时以上）
-
----
-
-## 七、参数组合测试
-
-**必须执行**：
-- 参数步长能快速验证结果
-- 组合参数的结果可得出对应需求目标
-- 思考时间设置符合用户使用场景
-
----
-
-## 重要提醒
-
-- 必须包含正常流程和异常流程测试
-- 必须包含边界值和非法数据测试
-- 必须包含安全和权限测试
-- 性能测试要有足够长的持续时间

package/rules/test-case-dev-rules.md

@@ -1,96 +0,0 @@
-<!--
-来源：全局 ~/.claude/rules/test-case-dev-rules.md v1.0（2026-04 起累计）
-下放到套件：2026-09-09（v2.6.3）
-后续治理：套件内自包含权威版本；全局版可作为兜底但优先以本文件为准
--->
-
-# 测试用例开发指南
-
-**触发条件**：编写单元测试、集成测试、开发者测试用例时
-
----
-
-## 一、测试用例基本要求
-
-**必须执行**：
-- 测试用例命名规范，描述清晰功能点
-- 测试用例前置条件与需求相符
-- 说明不同用户角色的测试场景
-- 定义通过/失败的可验证标准
-
----
-
-## 二、边界值测试
-
-**必须执行**：
-- 参数数据类型取值范围内正常验证
-- 参数数据类型取值范围外正常验证
-- 参数限制输入数据全值范围边界内验证
-- 参数限制输入数据全值范围边界外验证
-
-**数字字段必须测试**：
-- 超出范围的值
-- 负数
-- 小数
-- 零
-
-**字符字段必须测试**：
-- 空格
-- 非文字字符
-- 数字
-- 特殊符号
-
-**日期字段必须测试**：
-- 空格
-- 文字字符
-- 时间格式
-- 不合理日期值
-- 特殊符号
-
----
-
-## 三、空值 & 特殊值测试
-
-**必须执行**：
-- 参数值为空时验证
-- 参数值包含特殊字符时验证
-- 不提供任何输入数据时验证（空包、空数据）
-
----
-
-## 四、安全测试
-
-**必须执行**：
-- 包含重复提交的场景测试
-- 包含SQL注入测试（使用特殊字符 `'`, `"`, `;`, `--`）
-- 包含XSS攻击测试（使用 `<script>`, `javascript:`）
-- 验证敏感数据不能明文显示
-- 考虑越权场景测试
-
----
-
-## 五、并发 & 重复测试
-
-**必须执行**：
-- 设计连续两次相同数据的测试
-- 多线程同时请求同一资源的测试
-- 验证并发场景下数据一致性
-
----
-
-## 六、性能测试
-
-**必须执行**：
-- 考虑系统响应时间
-- 考虑不同规模数据下的响应时间
-- 考虑最大并发数
-- 考虑系统资源使用率
-
----
-
-## 重要提醒
-
-- 每个测试用例必须有明确的通过/失败标准
-- 测试步骤必须可执行并可验证结果
-- 必须覆盖所有必选参数
-- 必须组合可选参数进行测试