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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alanwang-merit/meritdata-platform-skill-package",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },

package/rules/api-design-rules.md

@@ -1,10 +1,3 @@
-<!--
-来源：研发skills/rules v1.0（2026-08 收录）
-抽取到 pfsuite/rules：2026-09-04
-后续治理：合并三方意见后再升级
--->
-
-
 # REST API 设计规范
 
 **触发条件**：设计REST API、编写接口文档、创建Controller时

package/rules/code-dev-rules.md

@@ -1,10 +1,3 @@
-<!--
-来源：研发skills/rules v1.0（2026-08 收录）
-抽取到 pfsuite/rules：2026-09-04
-后续治理：合并三方意见后再升级
--->
-
-
 # 代码开发指南
 
 **触发条件**：编写Java代码、开发功能模块时
@@ -96,72 +89,9 @@
 
 ---
 
-## 八、方法论铁律（双轨制：rules 摘要 + skill 详细）
-
-> **双轨制原则**：本节是"铁律摘要"，自动随 rules 加载生效；完整文档、反模式对比、根因分析、回归用例 见对应 skill 的 references/。详情见 `meritdata-platform-code-spec`、`meritdata-platform-data-boundary`、`meritdata-platform-domain-model` 三个 L2 方法论 skill。
-
-### 8.1 数据访问边界（data-boundary）
-
-**铁律 4 条**（完整版见 [`meritdata-platform-data-boundary.md`](./meritdata-platform-data-boundary.md)）：
-
-- 🔴 **不映射 `PF_` 前缀平台表**：二开库禁止 `@TableName("PF_*")` / 跨库 JOIN / 直连平台数据库
-- 🔴 **不分页循环逐条 Feign**：必须一次 Feign 批量装配 + 内存 join，禁止 `for + userClient.getById`
-- 🔴 **不复制平台 Entity/Repository**：独立部署场景下禁止 `import com.meritdata.cloud.platform.entity.*`
-- 🔴 **不掩盖平台故障**：禁止 `catch (Exception) { return Collections.emptyList(); }`，必须显式上抛
-
-### 8.2 业务建模规则（domain-model）
-
-**铁律 4 条**（完整版见 [`meritdata-platform-domain-model-rules.md`](./meritdata-platform-domain-model-rules.md)）：
-
-- 🔴 **二开业务表/字段必须小写蛇形**：`t_purchase_order`、`order_no`；实体类大驼峰 + `@Column` 显式映射
-- 🔴 **不得把人员/组织名称作为唯一关联键**：必须用稳定 `*_user_id` / `*_dept_id`，名称仅作冗余快照
-- 🔴 **跨服务禁止数据库外键**：通过应用层维护一致性，禁止 `FOREIGN KEY REFERENCES other_service.t_*`
-- 🔴 **唯一性校验必须穿透软删除**（见 §8.3）：`nativeQuery + findXxxIncludingDeleted` 穿透 `@Where`
-
-### 8.3 code-spec 补充铁律（编码层）
-
-**软删除实体**（核心反模式，根因：DB 唯一约束含软删除记录 + JPQL 受 `@Where` 过滤 → INSERT 500）：
-
-- ✅ 唯一性校验 `findXxxNo` 必须用 `findXxxIncludingDeleted`（`nativeQuery = true`）
-- ✅ 编号生成器"查已用编号"必须用 `findAllNosStartingWithIncludingDeleted`
-- ✅ 业务查询 / 全量查询必须**成对出现**（业务查询无后缀、全量查询 `IncludingDeleted` 后缀）
-
-**循环与外部资源**（重复 §四，再强调）：
-
-- 🔴 禁止 `for` 内调用 DB / Redis / HTTP / Feign
-- ✅ 必须批量查询 + 内存 join
-
-**异常处理**（重复 §五，再强调）：
-
-- 🔴 禁止空 catch / 吞异常（`return Collections.emptyList()` 是不掩盖的反例）
-- ✅ 必须 `throw new ServiceException("CODE", "msg", e)` 上抛 + 上下文
-
-**敏感信息**（重复 §六，再强调）：
-
-- 🔴 禁止日志打印 password / token / keytab / principal
-- ✅ 必须脱敏后打印（手机号、身份证、银行卡号）
-
-**架构层**：
-
-- 🔴 Controller / Service / Dao 层禁止有成员变量（除注解和常量）——避免线程安全问题
-- 🔴 Shell 脚本必须使用 Linux 换行符（`\n`，非 `\r\n`）——避免 Windows 部署脚本执行失败
-
-### 8.4 与 skill 的协作
-
-```
-[自动加载] rules 本节 → 所有 skill 都受硬约束
-    ↓ 开发者问"为什么这样" / "完整例子"
-[触发] 对应 skill（code-spec / data-boundary / domain-model）→ 加载 references/anti-patterns.md
-    ↓ 提交前
-[校验] skill 的 references/validate-rules.md 给出 CI 命令
-```
-
----
-
 ## 重要提醒
 
 - 循环内禁止调用外部资源
 - 任何密码等敏感信息严禁打印到日志
 - Controller/Service/Dao层禁止有成员变量（除注解和常量）
 - Shell脚本必须使用Linux换行符
-- **方法论铁律更新先改本 rules，再同步 skill 的 references/**（保证两边一致）

package/rules/coding-standards-rules.md

@@ -1,99 +0,0 @@
-<!--
-来源：研发skills/rules v1.0（2026-08 收录）
-抽取到 pfsuite/rules：2026-09-04
-合并入套件：2026-09-08
-修复说明：v2.6.x 抽取时丢失全部正文（仅留 198 字节 TODO stub），从全局 `~/.claude/rules/coding-standards-rules.md` 恢复 92 行真实内容。
--->
-
-# 编码规范
-
-**触发条件**：编写Java代码、开发功能模块时
-
----
-
-## 一、资源管理
-
-**必须执行**：
-- 使用 `try-with-resources` 自动关闭资源
-- 关闭顺序与开启顺序相反
-- 文件读取前检查是文件而非文件夹
-
-**禁止执行**：
-- 禁止在 `finally` 块中抛出异常
-- 禁止关闭连接后继续使用
-
-**正确示例**：
-```java
-try (InputStream in = new FileInputStream(file);
-     BufferedReader reader = new BufferedReader(new InputStreamReader(in))) {
-    // 使用 reader
-} // 自动关闭
-```
-
----
-
-## 二、集合处理
-
-**必须执行**：
-- 创建集合时指定初始容量：`new ArrayList<>(16)`、`new HashMap<>(16)`
-- 方法返回集合时，**返回空集合而非 null**：`return Collections.emptyList()`
-- 判断集合为空使用 `isEmpty()` 而非 `size() == 0`
-- 使用 `CollectionUtils.isEmpty()` 判断 null 或空
-
----
-
-## 三、字符串处理
-
-**必须执行**：
-- `equals` 比较时，**常量写在前面**：`"constant".equals(str)`
-- 避免不必要的字符串拼接，优先使用 StringBuilder
-- 拼接路径时使用 `/` 或 `Paths.get()`，避免硬编码分隔符
-
----
-
-## 四、异常处理
-
-**必须执行**：
-- 异常信息**脱敏后再记录日志**（移除 password、keytab、principal 等）
-- 使用自定义异常类 + 错误码，不直接暴露 JDK 异常
-- 接口调用要进行超时处理
-
-**禁止执行**：
-- 禁止空的 catch 块
-- 禁止吞掉异常不处理
-
----
-
-## 五、并发处理
-
-**必须执行**：
-- 线程池使用 `Executors` 工厂方法创建后，务必指定队列大小
-- 使用 `RateLimiter` 限流时设置合理的 QPS
-- 缓存 key **必须包含用户标识**实现用户隔离：`userId:appId`
-
----
-
-## 六、对象创建
-
-**禁止执行**：
-- 禁止在循环内创建大对象引用
-- 禁止在循环内调用外部资源（数据库、Redis、HTTP）
-
----
-
-## 七、日志规范
-
-**必须执行**：
-- 使用 SLF4J 日志门面
-- 日志级别：`ERROR`（业务异常）、`WARN`（降级处理）、`INFO`（关键流程）、`DEBUG`（调试）
-
-**禁止执行**：
-- **禁止记录敏感信息**：password、keytab、principal、token
-
----
-
-## 重要提醒
-
-- 资源必须及时关闭，否则会导致连接泄漏
-- 用户输入永远不可信，必须校验
-- 敏感信息最小化原则：只收集必要的信息

package/rules/data-boundary-rules.md

@@ -0,0 +1,32 @@
+---
+name: data-boundary-rules
+description: 美林平台数据边界硬约束 —— 二开业务库严禁连接 cloud 平台库、跨库 JOIN、复制平台 Entity；跨 JVM 数据访问必须走 Feign/API 批量装配，不得在分页循环中逐条 Feign。
+metadata:
+  type: rules
+  source: company
+  risk: high
+---
+
+# Cloud 数据边界（4 条铁律）
+
+## 强制原则
+
+1. **不连接 cloud 平台库** —— 二开业务库严禁直连 cloud 微服务平台表（`PF_` 前缀）
+2. **不跨库 JOIN** —— 业务表与平台表禁止跨库 JOIN，改用应用层内存 join
+3. **不复制平台 Entity/Repository** —— 人员/组织/角色/字典只保存稳定 ID/code，不复制平台 Java 实体
+4. **不掩盖故障** —— 平台不可用时显式上抛异常，不得用空集合/false 伪装成功
+
+## 实施要求
+
+- 跨 JVM 数据访问必须走 Feign/API 批量装配，**不得在分页循环中逐条 Feign**（N+1 问题）
+- 人员/组织/角色/字典等基础数据，**同 JVM 平台模块**用本地 Bean（详见 `meritdata-platform-entities`）
+- **跨 JVM 业务服务**用 Feign（详见 `meritdata-platform-integration`）
+- 写平台数据只调用明确开放的写契约，不臆造 Client
+- 涉及数据访问前**请阅读本 rules**学习完整约束
+
+## 校验方式
+
+- 静态扫描：`grep -r 'PF_[A-Z]' src/main/java/` 查找 PF_ 表映射
+- 静态扫描：`grep -rE 'JOIN\s+PF_' src/main/resources/mapper/` 查找跨库 JOIN
+- 静态扫描：`grep -r 'import com.meritdata.cloud.platform.entity' src/main/java/` 查找平台 Entity 引用
+- 提交前用 `meritdata-platform-2nd-dev-check` 体检

package/rules/frontend-coding-rules.md

@@ -1,9 +1,3 @@
-<!--
-来源：研发skills/rules v1.0（2026-08 收录）
-抽取到 pfsuite/rules：2026-09-04
-后续治理：合并三方意见后再升级
--->
-
 # 前端编程规范
 
 **触发条件**：编写Vue/Element UI前端代码、开发前端功能模块时

package/rules/frontend-component-rules.md

@@ -1,9 +1,3 @@
-<!--
-来源：研发skills/rules v1.0（2026-08 收录）
-抽取到 pfsuite/rules：2026-09-04
-后续治理：合并三方意见后再升级
--->
-
 # 前端组件和交互规范
 
 **触发条件**：设计前端组件、定义用户交互行为、开发Element UI组件时

package/rules/git-workflow-rules.md

@@ -1,9 +1,3 @@
-<!--
-来源：研发skills/rules v1.0（2026-08 收录）
-抽取到 pfsuite/rules：2026-09-04
-后续治理：合并三方意见后再升级
--->
-
 # Git 工作流
 
 **触发条件**：使用 Git 进行版本控制时

package/rules/nacos-rules.md

@@ -1,9 +1,3 @@
-<!--
-来源：研发skills/rules v1.0（2026-08 收录）
-抽取到 pfsuite/rules：2026-09-04
-后续治理：合并三方意见后再升级
--->
-
 # Nacos 配置中心规范（项目级）
 
 **触发条件**：在 cloud_back 项目中使用 Nacos 进行配置管理时

package/rules/naming-conventions-rules.md

@@ -1,9 +1,3 @@
-<!--
-来源：研发skills/rules v1.0（2026-08 收录）
-抽取到 pfsuite/rules：2026-09-04
-后续治理：合并三方意见后再升级
--->
-
 # 命名规范
 
 ---

package/rules/performance-rules.md

@@ -1,9 +1,3 @@
-<!--
-来源：研发skills/rules v1.0（2026-08 收录）
-抽取到 pfsuite/rules：2026-09-04
-后续治理：合并三方意见后再升级
--->
-
 # 性能规范
 
 **触发条件**：涉及数据库查询、缓存使用、并发处理、大数据量处理时

package/rules/security-rules.md

@@ -1,9 +1,3 @@
-<!--
-来源：研发skills/rules v1.0（2026-08 收录）
-抽取到 pfsuite/rules：2026-09-04
-后续治理：合并三方意见后再升级
--->
-
 # 安全编码规范
 
 **触发条件**：涉及用户认证、数据传输、权限控制、敏感信息处理时

package/rules/sql-naming-rules.md

@@ -1,9 +1,3 @@
-<!--
-来源：研发skills/rules v1.0（2026-08 收录）
-抽取到 pfsuite/rules：2026-09-04
-后续治理：合并三方意见后再升级
--->
-
 # SQL 命名规范
 
 **触发条件**：编写 SQL 语句、数据库表设计、字段命名、索引命名、数据库对象命名时

package/rules/sql-script-rules.md

@@ -1,9 +1,3 @@
-<!--
-来源：研发skills/rules v1.0（2026-08 收录）
-抽取到 pfsuite/rules：2026-09-04
-后续治理：合并三方意见后再升级
--->
-
 # SQL脚本提交规范
 
 **触发条件**：编写SQL脚本、数据库迁移、DML/DDL操作时