soloforge 1.1.42 → 1.1.43

package/templates/patterns/SOLID/350/256/276/350/256/241/350/247/204/350/214/203.md

@@ -1,30 +0,0 @@
----
-name: solid-design-pattern
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-pattern-solid-design
-lifecycle_status: active
-authority: supporting
-owner_mechanism_id: mc-ood-solid-contract
-priority: P1
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes:
-  - mc-ood-solid-contract
-emits: []
-type: pattern
-stages: ["联调验证"]
-triggers: ["SOLID","面向对象设计","职责划分","依赖倒置","接口隔离"]
----
-
-## 规则
-
-- 一个类只承担一个清晰可验证的业务原因。
-- 新增行为优先扩展端口或策略，避免修改大量既有条件分支。
-- 子类型必须保持父契约的有效输入、输出和错误语义。
-- 接口按消费者需要拆分，禁止空实现和不支持异常。
-- 业务核心依赖抽象，基础设施实现由装配层注入。
-- 简单修改不建立无用抽象层，避免为原则之名过度设计。

package/templates/patterns/Schema/345/205/274/345/256/271/350/247/204/350/214/203.md

@@ -1,40 +0,0 @@
----
-name: schema-compatibility
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-schema-compatibility
-lifecycle_status: active
-owner_mechanism_id: mc-backend-pattern
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["联调验证"]
-triggers: ["数据库变更","字段修改","表结构变更","数据迁移","Schema变更","加字段","改字段","删字段","DDL"]
----
-
-## 决策规则
-- 新增字段必须指定：默认值、可空性、存量数据回填策略
-- 修改字段类型、长度、语义或枚举范围必须指定：存量数据读取行为和迁移策略
-- 删除字段必须指定：兼容窗口、废弃标记、回滚计划，不得假设所有调用方已同步升级
-- 字段兼容策略必须同时覆盖四层：数据库、接口契约、前端展示、导出逻辑
-- 禁止在实现阶段临时决定兼容策略、删除语义或字段默认值
-- 数据库 Schema 变更必须向前兼容（先加新字段 → 迁移 → 再删旧字段）
-- 新增字段必须设默认值或允许 NULL，保证旧代码不受影响
-- 列类型变更必须分步进行（先加新列 → 双写 → 迁移 → 删旧列）
-- Schema 迁移脚本必须纳入版本控制，禁止手动执行 SQL
-- 索引变更必须在低峰期执行，大表加索引必须使用 ONLINE DDL 或 pt-osc
-
-## 验收项
-- [AC-01] 新增字段有默认值和回填策略
-- [AC-02] 字段变更覆盖数据库/接口/前端/导出四层
-- [AC-03] 删除字段有兼容窗口和回滚计划
-- [AC-04] 无临时决定的兼容策略
-- [AC-05] Schema 变更向前兼容
-- [AC-06] 新字段有默认值
-- [AC-07] 迁移脚本纳入版本控制

package/templates/patterns/Vue/347/212/266/346/200/201/347/256/241/347/220/206/350/247/204/350/214/203.md

@@ -1,40 +0,0 @@
----
-name: vue-state
-scope:
-  - frontend
-products:
-  - '*'
-id: ka-pattern-vue-state
-lifecycle_status: active
-owner_mechanism_id: mc-frontend-pattern
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["联调验证"]
-triggers: ["Vue状态管理","Pinia","Vuex","全局状态","store","Vue状态","状态共享","跨组件通信"]
----
-
-## 决策规则
-- 全局状态必须使用 Pinia，禁止 Vuex
-- Store 必须按业务模块拆分，禁止写单一大 Store
-- 组件解构 Store 必须使用 storeToRefs 保持响应性
-- 组件内局部状态用 ref/reactive，禁止滥用全局 Store
-- API 数据在 composable 中管理，必要时结合 Pinia 共享
-- 全局状态必须使用 Pinia store，禁止使用 Vuex（已废弃）或手动 provide/inject
-- Store 必须按功能模块拆分（useUserStore、useCartStore），禁止单个巨大 store
-- 异步操作必须在 store actions 中处理，禁止在组件中 dispatch 再 watch
-- Store 状态变更必须通过 actions，禁止在组件中直接修改 store.$state
-- 持久化状态必须使用 pinia-plugin-persistedstate 插件
-
-## 验收项
-- [AC-01] 全局状态使用 Pinia
-- [AC-02] Store 按业务模块拆分
-- [AC-03] 组件解构 Store 使用 storeToRefs
-- [AC-04] 组件内局部状态用 ref/reactive
-- [AC-05] 使用 Pinia 管理
-- [AC-06] Store 按模块拆分
-- [AC-07] 状态通过 actions 修改

package/templates/patterns/Vue/347/273/204/344/273/266/350/247/204/350/214/203.md

@@ -1,40 +0,0 @@
----
-name: vue-component
-scope:
-  - frontend
-products:
-  - '*'
-id: ka-pattern-vue-component
-lifecycle_status: active
-owner_mechanism_id: mc-frontend-pattern
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["联调验证"]
-triggers: [">-"]
----
-
-## 决策规则
-- 必须使用 `<script setup lang="ts">` 组合式 API，禁止选项式 API 新写组件
-- 组件超过 300 行必须拆分为子组件或 composables
-- Props 必须通过 defineProps + interface 定义，禁止使用 any
-- 禁止在组件中直接调用 axios，必须通过 service 层或 composable
-- 禁止 reactive 和 ref 混用导致响应性丢失
-- 组件必须使用 `<script setup>` + Composition API，禁止使用 Options API
-- 组件 Props 必须使用 defineProps<T>() 类型声明，禁止使用运行时声明
-- 组件 Emits 必须使用 defineEmits<T>() 声明，禁止未声明的 this.$emit
-- 组件必须有 name 属性（通过 defineOptions 或文件名约定），便于 DevTools 调试
-- 复用逻辑必须抽取为 Composable（use 前缀），禁止在组件间复制粘贴逻辑
-
-## 验收项
-- [AC-01] 使用 `<script setup lang="ts">` 组合式 API
-- [AC-02] Props 通过 defineProps + interface 定义
-- [AC-03] 组件不超过 300 行
-- [AC-04] 数据请求通过 service 层或 composable
-- [AC-05] 使用 script setup
-- [AC-06] Props 类型声明
-- [AC-07] 有 Composable 复用逻辑

package/templates/patterns/Vue/350/267/257/347/224/261/350/247/204/350/214/203.md

@@ -1,41 +0,0 @@
----
-name: vue-routing
-scope:
-  - frontend
-products:
-  - '*'
-id: ka-pattern-vue-routing
-lifecycle_status: active
-owner_mechanism_id: mc-frontend-pattern
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["联调验证"]
-triggers: ["Vue路由","Vue Router","页面跳转","Vue导航","路由守卫","路由配置","vue-router"]
----
-
-## 决策规则
-- 路由配置必须集中在 router/routes.ts
-- 页面组件必须使用动态 import 懒加载
-- 需要登录的页面必须有 meta.requiresAuth 标记
-- 权限检查必须在路由级别拦截，禁止仅隐藏菜单
-- 必须配置 404 兜底路由
-- 路由定义必须集中管理（router/index.ts），禁止散落各处
-- 页面组件必须使用路由懒加载（() => import()），减少首屏加载体积
-- 路由守卫必须统一处理鉴权逻辑（beforeEach），禁止每个路由单独处理
-- 路由 meta 必须声明权限要求（meta: { requiresAuth: true, roles: [] }）
-- 未匹配路由必须配置 404 兜底（/:pathMatch(.*)*）
-
-## 验收项
-- [AC-01] 路由配置集中在 router/routes.ts
-- [AC-02] 页面组件使用动态 import 懒加载
-- [AC-03] 需要登录的页面有 meta.requiresAuth
-- [AC-04] 有 404 兜底路由
-- [AC-05] 路由集中管理
-- [AC-06] 路由懒加载
-- [AC-07] 统一鉴权守卫
-- [AC-08] 404 兜底路由

package/templates/patterns//344/272/213/344/273/266/351/251/261/345/212/250/350/247/204/350/214/203.md

@@ -1,44 +0,0 @@
----
-name: event-driven
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-event-driven
-lifecycle_status: active
-owner_mechanism_id: mc-backend-pattern
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["联调验证"]
-triggers: ["事件驱动","事件溯源","领域事件","消息队列","MQ","异步消息","解耦","事件发布","Event Sourcing","CQRS","最终一致性"]
----
-
-## 决策规则
-- 跨模块非强一致性交互优先使用事件驱动（MQ），未使用时必须文档化原因
-- 事件必须幂等消费：消费者必须能安全处理重复消息（唯一约束/去重表/幂等键）
-- 事件消费失败必须有重试机制（建议 3 次）+ 死信队列（DLQ），禁止静默丢弃
-- 事件结构必须包含：事件类型、事件 ID（幂等键）、发生时间、聚合 ID、事件载荷
-- 禁止通过事件传递大对象（如完整订单），事件载荷只传 ID + 关键变更字段
-- 事件消费者异常不影响事件生产者（异步解耦），生产者不依赖消费者响应
-- 最终一致性场景必须定义：最大延迟容忍、补偿策略、对账机制
-- 禁止用消息队列做 RPC（同步等待响应），同步调用走 HTTP/Feign/gRPC
-- 事件消费者必须实现幂等处理，同一事件重复消费不能产生副作用
-- 事件必须包含版本号和发生时间，便于消费者兼容演进
-- 事件消费失败必须有重试机制（退避策略）和死信队列兜底
-- 关键业务事件必须持久化存储，不能只发 MQ 不落库
-- 事件体禁止包含大对象（如完整订单），应只传 ID 引用
-
-## 验收项
-- [AC-01] 跨模块交互使用事件驱动或有文档化原因
-- [AC-02] 事件消费幂等
-- [AC-03] 消费失败有重试 + 死信队列
-- [AC-04] 事件结构包含类型/ID/时间/载荷
-- [AC-05] 最终一致性有补偿和对账机制
-- [AC-06] 消费者幂等处理
-- [AC-07] 失败有重试和死信队列
-- [AC-08] 关键事件持久化

package/templates/patterns//344/272/213/345/212/241/346/250/241/345/274/217/350/247/204/350/214/203.md

@@ -1,40 +0,0 @@
----
-name: transaction-pattern
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-transaction-pattern
-lifecycle_status: active
-owner_mechanism_id: mc-backend-pattern
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["联调验证"]
-triggers: ["事务","@Transactional","分布式事务","事务传播","事务隔离","数据一致性","回滚","commit","rollback","补偿事务"]
----
-
-## 决策规则
-- 写操作 Service 方法必须标注 @Transactional，且显式指定 rollbackFor = Exception.class
-- 禁止在 Controller 层使用事务注解，事务边界必须在 Service 层
-- @Transactional 方法禁止被同类内部调用（AOP 代理失效），必须通过注入调用
-- 事务方法必须短小快速，禁止在事务中执行外部 HTTP 调用、文件 I/O、MQ 发送
-- 只读查询方法必须标注 @Transactional(readOnly = true)，降低数据库压力
-- 跨服务分布式事务优先使用最终一致性（事件 + 补偿），禁止强依赖 2PC/XA
-- 跨服务事务必须有补偿机制：正向操作失败自动补偿或定时对账修复
-- 嵌套事务优先使用 REQUIRES_NEW 分割独立事务单元，避免大事务锁表
-- 传播行为默认 REQUIRED 即可，禁止随意使用 REQUIRES_NEW（容易产生数据不一致）
-
-## 验收项
-- [AC-01] 写操作有 @Transactional(rollbackFor = Exception.class)
-- [AC-02] 事务方法无外部调用和文件 I/O
-- [AC-03] 只读方法有 readOnly = true
-- [AC-04] 跨服务事务有补偿机制
-- [AC-05] 无同类内部调用导致 AOP 失效
-- [AC-06] rollbackFor 显式指定
-- [AC-07] 无内部调用导致事务失效
-- [AC-08] 只读查询标注 readOnly

package/templates/patterns//344/274/230/351/233/205/345/201/234/346/234/272/350/247/204/350/214/203.md

@@ -1,42 +0,0 @@
----
-name: graceful-shutdown
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-graceful-shutdown
-lifecycle_status: active
-owner_mechanism_id: mc-backend-pattern
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["*"]
-triggers: ["优雅停机","服务下线","优雅关闭","shutdown","健康检查","readiness","liveness","启停","灰度发布","滚动更新"]
----
-
-## 决策规则
-- 服务必须实现优雅停机：收到 SIGTERM 后停止接收新请求，等待正在处理请求完成（建议超时 30s）
-- 必须提供健康检查端点：liveness（进程存活）和 readiness（服务就绪，依赖全部可用）
-- 滚动更新期间必须先从注册中心摘除再停机，禁止直接 kill 导致请求丢失
-- 启动时必须等待依赖组件就绪（DB 连接池、Redis、MQ）后再注册到服务发现
-- 定时任务必须在停机时中断执行并记录中断点，重启后可恢复
-- 连接池必须配置合理的超时和最大连接数，防止资源泄漏
-- Spring Boot 应用必须配置 server.shutdown=graceful + spring.lifecycle.timeout-per-shutdown-phase
-- 停机时必须等待正在处理的请求完成（graceful shutdown），设置等待超时（如 30s）
-- 线程池必须在停机时执行 shutdownNow() + awaitTermination()，确保任务不丢失
-- 定时任务必须在停机时停止调度，正在执行的任务必须完成或中断
-- 停机前必须从注册中心（如 Nacos/Eureka）注销，停止接收新流量
-- Spring Boot 必须配置 server.shutdown=graceful 和 spring.lifecycle.timeout-per-shutdown-phase
-
-## 验收项
-- [AC-01] 服务实现优雅停机（等待请求完成）
-- [AC-02] 健康检查区分 liveness/readiness
-- [AC-03] 滚动更新先摘除再停机
-- [AC-04] 启动时等待依赖就绪
-- [AC-05] 请求优雅完成
-- [AC-06] 线程池正确关闭
-- [AC-07] 从注册中心注销

package/templates/patterns//345/205/250/346/240/210/346/265/201/347/250/213/344/277/256/345/244/215.md

@@ -1,44 +0,0 @@
----
-name: fullstack-flowheal
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-pattern-fullstack-flowheal
-lifecycle_status: active
-owner_mechanism_id: mc-general-pattern
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["编码与单元测试", "联调验证"]
-triggers: ["流程修复","全栈诊断","E2E修复","修复流程","FlowHeal","诊断修复","跨层修复","流程异常"]
----
-
-## 决策规则
-- 必须严格遵循 5 步顺序：定义用例 → 收集证据 → 诊断 → 补丁计划 → 验证，禁止跳步
-- 证据优先、流程优先、浏览器证据优先、最小补丁、分层验证
-- 禁止将不稳定测试视为业务失败，先稳定复现再判断
-- 禁止删除断言、增加 sleep、降低覆盖率、增加 mock 来制造通过
-- 禁止用 SQL 直接写业务测试数据
-- 禁止自动修改事务/权限/金额/库存/安全策略
-- 一次只修一个问题，禁止跨层大重构同时进行
-- 高风险/低置信度/跨多服务的复杂变更上报人工决策
-- 端到端测试必须从浏览器页面出发，禁止绕过前端
-- 前后端联调必须基于接口文档（OpenAPI），禁止口头约定字段
-- 前后端字段命名不一致时以后端为准，前端通过映射层适配
-- 接口变更必须同步更新文档和前端调用，禁止只改一侧
-- 联调问题必须在缺陷系统记录根因（文档不完整/需求不明确/理解偏差），持续改进
-
-## 验收项
-- [AC-01] 遵循 5 步顺序（用例→证据→诊断→补丁→验证）
-- [AC-02] 证据包含 UI 追踪/API 调用/后端 traceId/数据状态
-- [AC-03] 修复后重新构建再验证
-- [AC-04] 最终状态显式声明（ready_to_commit/escalated/reverted）
-- [AC-05] 联调基于接口文档
-- [AC-06] 接口变更同步更新文档和前端
-- [AC-07] 联调问题记录根因

package/templates/patterns//345/210/206/351/241/265/346/237/245/350/257/242/350/247/204/350/214/203.md

@@ -1,39 +0,0 @@
----
-name: api-pagination
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-api-pagination
-lifecycle_status: active
-owner_mechanism_id: mc-backend-pattern
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["联调验证"]
-triggers: [">-"]
----
-
-## 决策规则
-- 必须使用数据库分页查询（LIMIT/OFFSET），禁止内存 subList 分页
-- 必须限制最大 pageSize（不超过 100）
-- 排序字段必须使用白名单校验，禁止直接拼接用户输入
-- 深分页（page > 1000）必须使用游标分页替代 OFFSET
-- 分页响应必须包含 total、page、size、totalPages 字段
-- 深分页（offset > 10000）必须使用游标分页或子查询优化，禁止直接 OFFSET
-- 分页查询禁止使用 SELECT *，必须指定所需字段
-- 排序字段必须是索引列，禁止对非索引列排序导致全表扫描
-- 前端分页控件必须显示总条数和页码跳转
-
-## 验收项
-- [AC-01] page >= 1 且 1 <= size <= 100
-- [AC-02] 使用数据库分页而非内存分页
-- [AC-03] 响应含 total/page/size/totalPages
-- [AC-04] 排序字段白名单校验
-- [AC-05] 深分页有优化策略
-- [AC-06] 排序字段使用索引列
-- [AC-07] 前端有页码跳转

package/templates/patterns//345/211/215/347/253/257/346/200/247/350/203/275/350/247/204/350/214/203.md

@@ -1,45 +0,0 @@
----
-name: frontend-performance
-scope:
-  - frontend
-products:
-  - '*'
-id: ka-pattern-frontend-performance
-lifecycle_status: active
-owner_mechanism_id: mc-frontend-pattern
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["编码与单元测试", "架构设计"]
-triggers: ["前端性能","页面加载","首屏时间","性能优化","懒加载","代码分割","bundle","白屏时间","FCP","LCP","内存泄漏"]
----
-
-## 决策规则
-- 路由级别必须使用懒加载（React.lazy / dynamic import），禁止首屏加载所有页面代码
-- 大型第三方库（图表、富文本编辑器）必须按需加载，禁止全量引入
-- 图片必须使用懒加载（Intersection Observer 或 loading="lazy"），大图必须压缩和适配分辨率
-- 列表数据超过 100 条必须使用虚拟滚动（react-window / react-virtualized）
-- 组件卸载时必须清理副作用（定时器、WebSocket、事件监听），防止内存泄漏
-- useEffect 依赖数组必须准确，禁止无依赖导致每次渲染执行
-- 重复渲染必须用 React.memo / useMemo / useCallback 优化，但禁止过度优化（简单组件不需要 memo）
-- 首屏关键资源必须预加载，非关键资源延迟加载
-- 首屏加载时间必须 ≤ 3s（Fast 3G），超过时必须优化（懒加载、代码分割、CDN）
-- 列表渲染超过 100 行必须使用虚拟滚动（react-window / vue-virtual-scroller）
-- 组件重渲染必须有明确优化（React.memo / useMemo / shouldComponentUpdate）
-- 图片资源必须使用 WebP 格式 + CDN 加速 + 懒加载
-- 生产构建必须开启 Tree Shaking + Code Splitting + Gzip 压缩
-
-## 验收项
-- [AC-01] 路由级别懒加载
-- [AC-02] 大型库按需引入
-- [AC-03] 组件卸载清理副作用
-- [AC-04] useEffect 依赖准确无冗余执行
-- [AC-05] 长列表使用虚拟滚动
-- [AC-06] 首屏 ≤ 3s
-- [AC-07] 长列表虚拟滚动
-- [AC-08] 图片 WebP + CDN + 懒加载
-- [AC-09] 生产构建优化开启

package/templates/patterns//345/220/216/347/253/257/345/256/236/347/216/260/345/267/245/347/250/213/350/247/204/350/214/203.md

@@ -1,30 +0,0 @@
----
-name: backend-implementation-engineering
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-backend-implementation-engineering
-lifecycle_status: active
-authority: supporting
-owner_mechanism_id: mc-backend-implementation-contract
-priority: P1
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes:
-  - mc-backend-implementation-contract
-emits: []
-type: pattern
-stages: ["编码与单元测试", "联调验证"]
-triggers: ["Controller","DTO","API实现","事务","幂等","权限","后端编码"]
----
-
-## 工程规则
-
-- Controller 入参与出参按接口语义使用 DTO/VO，不暴露数据库实体。
-- 参数必须验证必填、长度、枚举、金额、日期区间和关联对象存在性。
-- 列表接口限制 page size 并对白名单排序；响应使用统一分页对象。
-- 写操作在 Service 定义清晰事务边界；外部调用不放在长事务内。
-- 支付、回调、创建与状态流转具备幂等键、并发控制和重复提交测试。
-- 敏感操作必须校验权限和租户，并产出可追踪审计记录。
-- OpenAPI、字段表、错误码和 migration 必须与实现同步复验。

package/templates/patterns//345/221/275/345/220/215/350/247/204/350/214/203.md

@@ -1,45 +0,0 @@
----
-name: naming-convention
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-pattern-naming-convention
-lifecycle_status: active
-owner_mechanism_id: mc-general-pattern
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["编码与单元测试", "架构设计"]
-triggers: ["命名规范","命名约定","变量命名","类命名","接口命名","表命名","字段命名","API路径命名"]
----
-
-## 决策规则
-- Java 类名使用 UpperCamelCase，方法/变量使用 lowerCamelCase，常量使用 UPPER_SNAKE_CASE
-- 数据库表名使用 snake_case，字段名使用 snake_case，主键统一命名为 id
-- API 路径使用 kebab-case 复数名词（如 /api/v1/user-orders），禁止在路径中使用动词
-- 前端组件文件名使用 PascalCase，CSS 类名使用 kebab-case，路由路径使用 kebab-case
-- 禁止使用无业务含义的命名（data、info、result、temp、list、item、obj）
-- Boolean 变量/方法必须以 is/has/can/should 开头（如 isActive、hasPermission）
-- 接口/抽象类命名应体现行为意图（如 UserRepository、PaymentService）
-- 枚举类名使用名词，枚举值使用 UPPER_SNAKE_CASE
-- 包名使用全小写点分隔（com.company.module.service），禁止下划线或大写
-- 常量必须定义在常量类或枚举中，禁止散落在业务代码各处
-- 方法名应为动词或动词短语（getUserById、calculateTotalAmount）
-- 泛型类型参数使用大写单字母或简写（T、E、K、V、R、REQ、RESP）
-- 配置项 key 使用点分隔的 kebab-case（spring.datasource.url）
-
-## 验收项
-- [AC-01] Java 类/方法/变量/常量命名风格一致
-- [AC-02] 数据库表名/字段名统一 snake_case
-- [AC-03] API 路径 kebab-case + 复数名词
-- [AC-04] 前端组件 PascalCase、CSS kebab-case
-- [AC-05] 无无含义命名（data/info/result/temp）
-- [AC-06] Boolean 变量 is/has/can 前缀
-- [AC-07] 方法名为动词短语
-- [AC-08] 枚举值 UPPER_SNAKE_CASE

package/templates/patterns//345/233/275/351/231/205/345/214/226/350/247/204/350/214/203.md

@@ -1,43 +0,0 @@
----
-name: i18n-l10n
-scope:
-  - frontend
-products:
-  - '*'
-id: ka-pattern-i18n-l10n
-lifecycle_status: active
-owner_mechanism_id: mc-frontend-pattern
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["编码与单元测试"]
-triggers: ["国际化","多语言","i18n","l10n","语言切换","多语言支持","本地化","翻译","locale","中英文"]
----
-
-## 决策规则
-- 所有用户可见文案禁止硬编码，必须使用 i18n key（如 t('user.login.title')）
-- 日期格式必须按 locale 显示（中文 yyyy-MM-dd，英文 MM/dd/yyyy），禁止固定格式
-- 金额必须按 locale 格式化（符号位置、千位分隔符、小数位数）
-- 后端接口返回的錙误码必须映射为前端多语言提示，禁止直接展示后端錙误消息
-- 语言资源文件必须按模块拆分，禁止单一大文件（建议 pages/common/components 分目录）
-- 新增语言只需新增资源文件，不修改业务代码
-- 接口返回的业务数据（枚举、状态名）由后端提供多语言字段，前端不维护业务数据翻译
-- 所有用户可见文本必须通过 i18n 资源文件管理，禁止硬编码字符串
-- 日期/时间必须根据用户时区显示，禁止使用服务端固定时区
-- 数字/货币格式必须根据 locale 格式化（如 1,234.56 vs 1.234,56）
-- 文案翻译必须由专业翻译完成，禁止机器翻译直接上线
-- 多语言文案禁止拼装（如 "欢迎" + userName），应使用带占位符的完整模版
-
-## 验收项
-- [AC-01] 用户可见文案通过 i18n key 引用
-- [AC-02] 日期和金额按 locale 格式化
-- [AC-03] 錙误码映射为多语言提示
-- [AC-04] 资源文件按模块拆分
-- [AC-05] 无硬编码用户可见文本
-- [AC-06] 日期时间按时区显示
-- [AC-07] 数字货币按 locale 格式化
-- [AC-08] 无拼装多语言文案

package/templates/patterns//345/242/236/345/210/240/346/224/271/346/237/245/350/247/204/350/214/203.md

@@ -1,43 +0,0 @@
----
-name: crud-operation
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-crud-operation
-lifecycle_status: active
-owner_mechanism_id: mc-backend-pattern
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["联调验证"]
-triggers: ["CRUD","增删改查","新建接口","修改数据","删除数据","查询详情","编辑","保存","入库","新增功能"]
----
-
-## 决策规则
-- 必须遵循 Controller → Service → Mapper/Repository 三层分离
-- 禁止 Controller 包含业务逻辑（if/else 分支、计算、状态机）
-- 禁止 DTO 和 Entity 混用，外部请求不可直接操作数据库字段
-- 批量操作禁止在循环中逐条调用数据库
-- 写操作 Service 方法必须有 @Transactional 注解
-- 删除操作必须记录操作人和原因
-- 列表查询接口必须返回分页结构（total、list、pageNum、pageSize），禁止返回全量数据
-- 创建/更新接口必须返回完整实体或 ID，禁止返回 void
-- 逻辑删除必须使用统一字段（如 is_deleted），禁止物理删除业务数据
-- 并发更新场景必须使用乐观锁（version 字段或更新时间条件），防止数据覆盖
-- 批量更新/删除操作必须有数量上限（如 ≤ 500 条），防止大批量锁表
-
-## 验收项
-- [AC-01] Controller 无业务逻辑
-- [AC-02] DTO/Entity 分离
-- [AC-03] 写操作有事务注解
-- [AC-04] 批量操作使用 batch SQL
-- [AC-05] 删除有审计记录
-- [AC-06] 列表查询返回分页结构
-- [AC-07] 创建/更新返回完整数据
-- [AC-08] 逻辑删除而非物理删除
-- [AC-09] 并发更新有乐观锁保护

package/templates/patterns//345/244/226/351/203/250/344/276/235/350/265/226/350/247/204/350/214/203.md

@@ -1,41 +0,0 @@
----
-name: external-dependency
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-external-dependency
-lifecycle_status: active
-owner_mechanism_id: mc-backend-pattern
-authority: supporting
-priority: P2
-version: 1.1.0
-last_reviewed: '2026-06-01'
-consumes: []
-emits: []
-type: pattern
-stages: ["联调验证"]
-triggers: ["外部依赖","第三方接口","外部服务调用","HTTP客户端","Feign","RPC","微服务调用","超时","重试","降级"]
----
-
-## 决策规则
-- 每个外部依赖调用必须定义超时时间，禁止无限等待
-- 需要重试时必须同时定义幂等或去重策略，避免重复副作用
-- 需要降级时必须定义：降级行为、用户提示、恢复条件
-- 新增配置项必须文档化：默认值、环境差异、灰度方式、回滚策略
-- 外部调用失败必须有区别于业务异常的错误码和用户提示
-- 外部依赖必须设置合理的超时时间（连接超时 + 读超时），禁止无限等待
-- 外部依赖调用必须有熔断保护，连续失败 N 次自动熔断
-- 外部依赖必须有降级策略（返回缓存数据/默认值），不能因为依赖故障拖垮主流程
-- 第三方库版本必须锁定（package-lock.json / Gradle version），禁止使用 latest 或范围版本
-- 外部依赖的健康检查必须纳入监控，响应时间/成功率异常时触发告警
-
-## 验收项
-- [AC-01] 外部调用有超时配置
-- [AC-02] 重试操作有幂等/去重策略
-- [AC-03] 降级场景有用户提示和恢复条件
-- [AC-04] 外部调用失败有独立错误码
-- [AC-05] 外部调用有超时配置
-- [AC-06] 有熔断和降级策略
-- [AC-07] 依赖版本锁定
-- [AC-08] 依赖健康检查有监控