soloforge 1.1.40 → 1.1.43

package/templates/patterns//346/220/234/347/264/242/346/250/241/345/274/217/350/247/204/350/214/203.md

@@ -1,45 +0,0 @@
----
-name: search-pattern
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-pattern-search-pattern
-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: ["搜索","全文搜索","搜索功能","筛选","过滤","查询条件","多条件查询","动态查询","Elasticsearch","搜索引擎","模糊搜索"]
----
-
-## 决策规则
-- 列表筛选条件超过 3 个必须封装为 SearchRequest 对象，禁止平铺查询参数
-- 动态查询必须使用 MyBatis 动态 SQL 或 JPA Specification，禁止字符串拼接 SQL
-- 模糊搜索（LIKE）必须考虑前缀匹配和索引利用，禁止全表扫描 `%keyword%`
-- 大数据量全文搜索必须使用 Elasticsearch，禁止数据库 LIKE 性能瓶颈
-- 搜索结果必须分页，禁止返回全量匹配结果
-- 搜索条件组合必须明确 AND/OR 语义，禁止歧义
-- 搜索接口响应时间目标 < 200ms，超过时必须优化（索引/缓存/ES）
-- 前端搜索框必须有防抖（建议 300ms），禁止每次按键触发请求
-- 搜索接口必须支持分页，禁止无限制返回结果
-- 搜索结果必须高亮关键词，提升用户定位效率
-- 搜索字段必须建立索引（Elasticsearch mapping 或数据库索引），禁止全表扫描
-- 搜索关键词必须做长度限制和特殊字符过滤，防止恶意查询
-- 搜索结果必须按相关度排序，支持用户自定义排序条件
-
-## 验收项
-- [AC-01] 筛选条件封装为对象
-- [AC-02] 动态查询无 SQL 拼接
-- [AC-03] 搜索结果分页
-- [AC-04] 搜索接口响应 < 200ms
-- [AC-05] 前端搜索有防抖
-- [AC-06] 搜索接口分页
-- [AC-07] 关键词高亮
-- [AC-08] 搜索字段有索引

package/templates/patterns//346/225/260/346/215/256/351/232/220/347/247/201/350/247/204/350/214/203.md

@@ -1,44 +0,0 @@
----
-name: data-privacy
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-pattern-data-privacy
-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: ["数据隐私","脱敏","敏感数据","个人信息","PII","GDPR","数据保护","数据安全","手机号","身份证","银行卡","数据加密"]
----
-
-## 决策规则
-- 手机号、身份证号、银行卡号、邮箱、地址等 PII 字段必须脱敏展示（手机号 `138****1234`，身份证 `310***********1234`）
-- 数据库中密码必须 BCrypt 哈希，身份证/银行卡等必须 AES 加密存储，禁止明文
-- 日志中禁止打印完整 PII 字段，必须脱敏或掩码处理
-- 接口响应中敏感字段必须默认脱敏，需要明文的场景必须单独授权接口
-- 数据导出（Excel/CSV）包含 PII 字段时必须有权限控制和操作审计
-- 用户注销/数据删除请求必须级联清理所有关联 PII 数据，包括备份中的软删除标记
-- 数据查询接口禁止支持全量导出 PII 数据，必须分页且有导出上限
-- 前端禁止在 URL 参数、LocalStorage 明文存储敏感信息
-- 个人敏感信息（身份证、手机号、银行卡）存储必须加密或脱敏
-- 数据删除必须支持真删除（不只是软删除标记），满足 GDPR/个人信息保护法要求
-- 用户注销必须清除或匿名化关联个人数据，不能只禁用账号
-- 用户数据导出必须经过审批，导出文件必须加密传输
-
-## 验收项
-- [AC-01] PII 字段展示时有脱敏处理
-- [AC-02] 敏感字段加密存储非明文
-- [AC-03] 日志不含完整 PII 数据
-- [AC-04] 数据导出有权限控制和审计
-- [AC-05] 用户注销关联数据已清理
-- [AC-06] 敏感信息加密存储
-- [AC-07] 接口/日志中敏感信息脱敏
-- [AC-08] 支持数据真删除和匿名化

package/templates/patterns//346/226/207/344/273/266/344/270/212/344/274/240/350/247/204/350/214/203.md

@@ -1,43 +0,0 @@
----
-name: file-upload
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-file-upload
-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: ["文件上传","上传文件","文件存储","OSS","图片上传","附件上传","multipart","文件下载","对象存储"]
----
-
-## 决策规则
-- 文件必须存储到对象存储（OSS/MinIO/S3），禁止存本地磁盘
-- 必须校验文件类型白名单（禁止 .exe/.sh/.jsp 等）
-- 必须限制文件大小（默认 10MB）
-- 禁止使用原始文件名，必须 UUID 重命名防路径遍历
-- 上传接口必须校验文件 MIME 类型和扩展名双重验证
-- 图片类上传必须校验实际文件头（magic bytes），不能只依赖扩展名
-- 必须配置上传文件总容量限制（单个用户/租户），防止存储滥用
-- 下载链接必须使用签名 URL 或一次性 token，禁止永久公开 URL
-- 禁止上传目录有执行权限（chmod -x），防止上传的脚本被服务器执行
-- 文件上传必须异步处理（先上传再后台扫描），大文件必须支持断点续传
-- 必须记录文件上传/下载审计日志（操作人、时间、文件名、大小）
-
-## 验收项
-- [AC-01] 文件类型白名单校验
-- [AC-02] 文件大小限制（默认 10MB）
-- [AC-03] UUID 重命名文件
-- [AC-04] 存储在对象存储而非本地磁盘
-- [AC-05] 文件头 magic bytes 校验
-- [AC-06] 用户/租户存储容量限制
-- [AC-07] 下载链接签名或一次性 token
-- [AC-08] 上传目录无执行权限
-- [AC-09] 上传/下载审计日志

package/templates/patterns//346/227/240/351/232/234/347/242/215/350/247/204/350/214/203.md

@@ -1,45 +0,0 @@
----
-name: accessibility
-scope:
-  - frontend
-products:
-  - '*'
-id: ka-pattern-accessibility
-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: ["无障碍","可访问性","a11y","ARIA","键盘导航","屏幕阅读器","语义化","WCAG","辅助功能"]
----
-
-## 决策规则
-- 表单 input 必须关联 label（htmlFor/id 或 aria-labelledby），禁止无标签输入框
-- 按钮和链接必须有可识别文本或 aria-label，禁止纯图标按钮无文字说明
-- 页面必须支持键盘导航（Tab 序列、Enter/Space 触发），焦点顺序符合视觉逻辑
-- 动态内容更新必须使用 aria-live 区域通知屏幕阅读器
-- 颜色对比度必须满足 WCAG AA 标准（文本 4.5:1，大文本 3:1）
-- 图标按钮必须提供 aria-label 或 tooltip，图标作为装饰时使用 aria-hidden="true"
-- 错误提示必须通过 aria-describedby 关联到对应表单字段
-- 所有交互元素必须有可访问的名称（aria-label 或关联 label），屏幕阅读器可识别
-- 颜色对比度必须满足 WCAG 2.1 AA 标准（正文 ≥ 4.5:1，大文本 ≥ 3:1）
-- 所有功能必须支持键盘操作（Tab 导航 + Enter/Space 触发），不能仅依赖鼠标
-- 表单必须有明确的错误提示和关联（aria-describedby），不能只用颜色标识错误
-- 图片/图标必须有替代文本（alt 属性），装饰性图片使用 alt=""
-- 页面标题（title）和标题层级（h1-h6）必须语义正确，便于辅助导航
-
-## 验收项
-- [AC-01] 表单字段有关联 label
-- [AC-02] 按钮和链接有可识别文本
-- [AC-03] 页面支持键盘导航
-- [AC-04] 颜色对比度满足 WCAG AA
-- [AC-05] 交互元素有 aria-label
-- [AC-06] 颜色对比度符合 WCAG AA
-- [AC-07] 功能支持键盘操作
-- [AC-08] 表单错误有关联提示
-- [AC-09] 图片有替代文本

package/templates/patterns//346/227/245/345/277/227/350/247/204/350/214/203.md

@@ -1,43 +0,0 @@
----
-name: logging
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-logging
-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: ["日志记录","日志","log","打日志","链路追踪","MDC","traceId","日志格式","记录日志","操作日志"]
----
-
-## 决策规则
-- 必须使用 SLF4J + Logback，禁止 System.out.println
-- 所有请求必须有 traceId 贯穿完整链路（MDC Filter）
-- 关键业务操作（创建/修改/删除）必须记录 INFO 日志
-- 禁止日志中打印敏感信息（密码、token、身份证号），敏感字段必须脱敏
-- ERROR 日志必须包含异常堆栈（log.error("msg", e)）
-- 所有新增/修改/删除/审核/审批/发放/冻结/解冻等写操作必须有审计落点
-- 审计至少包含：操作者、操作时间、操作对象、来源入口、关键前后值或结果摘要
-- 关键路径（写操作、状态变更、外部调用、异常捕获）必须有日志，只读查询不得为满足规则而硬加日志
-- 禁止在循环中打印日志（尤其是 DEBUG 级别），防止日志洪泛
-- 异常日志必须包含完整堆栈（log.error("msg", exception)），禁止只打印 getMessage()
-- 生产环境禁止使用 DEBUG/TRACE 级别日志
-
-## 验收项
-- [AC-01] 所有请求有 traceId 贯穿
-- [AC-02] 关键操作记录 INFO 日志
-- [AC-03] 日志不含敏感信息
-- [AC-04] 无 System.out.println
-- [AC-05] 写操作有审计记录（操作者/时间/对象/来源）
-- [AC-06] 关键路径有日志且只读查询无冗余日志
-- [AC-07] 关键操作有审计日志
-- [AC-08] 日志包含 traceId
-- [AC-09] 异常日志包含完整堆栈

package/templates/patterns//346/235/203/351/231/220/350/256/244/350/257/201/350/247/204/350/214/203.md

@@ -1,47 +0,0 @@
----
-name: auth-permission
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-auth-permission
-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: ["权限认证","权限校验","认证","登录","鉴权","授权","Token","JWT","RBAC","角色","@PreAuthorize","登录验证","访问控制"]
----
-
-## 决策规则
-- 所有写接口必须有权限注解或 URL 级别鉴权
-- 禁止在 Controller 中硬编码角色判断（if role == "ADMIN"）
-- JWT Token 必须设置过期时间（建议 2-8 小时）
-- 密码必须使用 BCrypt 哈希存储，禁止明文或可逆加密
-- 前端隐藏按钮不能替代后端权限校验
-- 任何新增或修改菜单必须同步声明角色、权限标识、默认可见性和数据范围
-- 页面可见不等于可操作，按钮权限、接口权限和数据权限必须分别定义
-- 接口鉴权要求必须能回链到角色与权限模型，不能只写 auth=token
-- 禁止菜单可见性与接口可调用性解耦（菜单隐藏但接口暴露）
-- 登录失败不得提示具体原因（不区分"用户名不存在"和"密码错误"）
-- 登录接口必须有暴力破解防护（连续失败 N 次锁定或验证码）
-- Session ID 必须在登录成功后重新生成，防止会话固定攻击
-- 前端敏感操作（修改密码、删除）必须重新验证身份（re-authentication）
-- API 接口必须实现限流（Rate Limiting），防止暴力枚举和 CC 攻击
-
-## 验收项
-- [AC-01] 写接口有权限注解或鉴权
-- [AC-02] Token 有过期时间
-- [AC-03] 密码 BCrypt 哈希存储
-- [AC-04] 无硬编码角色判断
-- [AC-05] 菜单/按钮/接口/数据范围三层权限同步定义
-- [AC-06] 接口鉴权可回链到角色权限模型
-- [AC-07] 登录失败不暴露具体原因
-- [AC-08] 有暴力破解防护机制
-- [AC-09] 敏感操作重新验证身份
-- [AC-10] API 接口有限流策略

package/templates/patterns//346/236/266/346/236/204/347/272/242/347/272/277.md

@@ -1,42 +0,0 @@
----
-name: architecture-redline
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-architecture-redline
-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: ["架构设计","系统架构","模块划分","服务边界","架构红线","跨模块调用","服务拆分"]
----
-
-## 决策规则
-- 禁止绕过统一认证和数据范围控制直接暴露业务接口
-- 禁止通过 Patch JAR、docker commit 或运行时文件替换交付代码
-- 禁止前端、Controller 或定时任务跨服务边界直接访问持久化实现
-- 禁止将事务、认证、金额、库存、安全策略或数据库 Schema 变更打包为"小修改"而无设计追溯
-- 禁止菜单可见性与接口可调用性解耦（菜单隐藏但接口暴露，或菜单存在但无权限支撑）
-- 禁止异步消息、定时任务或补偿逻辑绕过主路径审计和幂等控制
-- 所有新增写操作必须有可追溯的审计记录
-- 禁止在循环内执行数据库操作（N+1），必须使用批量查询
-- 禁止在事务内执行远程调用（HTTP/RPC），防止长事务锁表
-- 禁止 catch 后空处理，至少记录日志并标注忽略原因
-- 禁止直接使用 new Date() 获取时间，必须通过时钟服务注入便于测试
-- 禁止在 Service 层注入 HttpServletRequest/Response，保持层级清晰
-
-## 验收项
-- [AC-01] 业务接口经过统一认证
-- [AC-02] 无跨边界直接持久化访问
-- [AC-03] 菜单与接口权限同步定义
-- [AC-04] 写操作有审计记录
-- [AC-05] 无循环内数据库调用
-- [AC-06] 无事务内远程调用
-- [AC-07] 无空 catch 块

package/templates/patterns//346/265/213/350/257/225/350/264/250/351/207/217/350/247/204/350/214/203.md

@@ -1,43 +0,0 @@
----
-name: testing-quality
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-pattern-testing-quality
-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测试","测试反模式"]
----
-
-## 决策规则
-- 每个接口至少覆盖：正常流程、参数缺失、权限不足、业务异常、边界值
-- 端到端业务测试必须从浏览器页面模拟真实用户操作，直接 API 调用只能补充不能替代
-- 测试失败必须在源逻辑修复，禁止修改测试来适配 Bug
-- 测试数据准备必须走业务 API 或页面操作，禁止直接 SQL INSERT 业务数据
-- 禁止在测试脚本中硬编码凭据，必须从环境变量或配置文件读取
-- Docker 部署必须从全新镜像构建，禁止 docker commit 和热补丁
-- 单元测试覆盖率核心逻辑必须 ≥ 80%，关键路径（支付/权限）必须 100%
-- 测试方法命名必须清晰表达测试场景（如 shouldReturn401WhenTokenExpired）
-- 测试数据必须使用工厂方法或 Builder 构建，禁止硬编码 magic values
-- 集成测试必须使用测试容器（Testcontainers）或内存数据库，禁止依赖外部环境
-- 每个修复的 bug 必须有对应的回归测试，防止问题复现
-
-## 验收项
-- [AC-01] 接口测试覆盖正常+异常+边界
-- [AC-02] E2E 测试从浏览器模拟用户操作
-- [AC-03] 测试失败修复源逻辑而非改测试
-- [AC-04] 测试数据走业务 API 非 SQL 直写
-- [AC-05] 核心逻辑覆盖率 ≥ 80%
-- [AC-06] 测试方法名清晰表达场景
-- [AC-07] 测试数据工厂构建
-- [AC-08] Bug 修复有回归测试

package/templates/patterns//347/206/224/346/226/255/351/231/215/347/272/247/350/247/204/350/214/203.md

@@ -1,45 +0,0 @@
----
-name: circuit-breaker
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-circuit-breaker
-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: ["服务降级","熔断","限流","降级","级联故障","服务雪崩","Sentinel","Hystrix","Resilience4j","服务保护","容错"]
----
-
-## 决策规则
-- 外部依赖（第三方 API、中间件、其他微服务）必须配置超时时间，禁止无限等待
-- 核心链路的外部调用必须配置熔断器：失败率阈值（建议 50%）、熔断时长（建议 30s）、半开探测数（建议 5）
-- 熔断触发后必须有降级策略：返回缓存数据/默认值/友好提示，禁止直接抛异常给用户
-- 接口必须有限流保护（令牌桶/漏桶），防止突发流量击穿服务
-- 降级方案必须提前定义：降级行为、用户提示文案、数据一致性保障、恢复条件
-- 重试必须满足幂等性，重试间隔必须使用指数退避（initial 100ms, multiplier 2, max 3 次）
-- 线程池隔离：不同外部依赖使用独立线程池，防止一个慢服务拖垮所有请求
-- 必须有服务健康检查端点（/actuator/health），包含依赖组件状态（DB/Redis/MQ）
-- 熔断器必须配置 half-open 状态的探测请求量（如允许 5 个请求通过测试），成功后才恢复
-- 降级 fallback 必须返回有意义的默认值或缓存数据，禁止返回 null 或空对象
-- 熔断/降级事件必须触发监控告警，不能静默降级
-- 外部调用必须设置独立的超时时间（不依赖全局超时），与熔断器配合使用
-- 熔断器状态变化必须有日志记录（closed → open → half-open → closed）
-
-## 验收项
-- [AC-01] 外部调用有超时和熔断配置
-- [AC-02] 熔断后有降级策略和用户提示
-- [AC-03] 重试有指数退避和幂等保障
-- [AC-04] 有限流保护
-- [AC-05] 健康检查端点包含依赖状态
-- [AC-06] half-open 探测机制配置
-- [AC-07] fallback 返回有意义的值
-- [AC-08] 熔断事件有监控告警
-- [AC-09] 外部调用有独立超时

package/templates/patterns//347/212/266/346/200/201/346/265/201/350/275/254/350/247/204/350/214/203.md

@@ -1,41 +0,0 @@
----
-name: state-transition
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-state-transition
-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: ["状态机","状态流转","状态变更","状态转换","审批流","工单状态","订单状态","流程引擎"]
----
-
-## 决策规则
-- 仅列出状态列表不够，每个状态转换必须定义：触发条件、守卫条件、失败/回滚动作
-- 金额、库存、配额、计数器等并发敏感节点默认需要并发控制
-- 并发敏感操作必须显式声明：并发控制方式（乐观锁/悲观锁/幂等键/去重表）、重试策略、重复提交处理、用户可见失败反馈
-- 跨模块或跨服务状态变更必须显式声明最终一致性和补偿策略
-- 集成测试必须覆盖：至少一次成功转换、一次守卫失败、一次失败恢复或升级路径
-- 状态流转必须通过状态机框架（如 Spring Statemachine）或显式流转表校验，禁止硬编码 if-else
-- 每次状态变更必须记录流转日志（原状态→新状态、操作人、时间、原因）
-- 并发状态变更必须使用乐观锁或分布式锁，防止状态覆盖
-- 状态流转失败必须返回明确的错误原因，告知用户当前状态和允许的下一步操作
-- 状态定义必须包含初始状态和终态，禁止出现无法流转的"悬挂状态"
-
-## 验收项
-- [AC-01] 状态转换有触发条件、守卫条件、回滚动作
-- [AC-02] 并发敏感操作有显式并发控制声明
-- [AC-03] 跨服务状态变更有补偿策略
-- [AC-04] 集成测试覆盖成功和失败路径
-- [AC-05] 状态机校验（非硬编码）
-- [AC-06] 状态变更审计日志
-- [AC-07] 并发状态变更防护
-- [AC-08] 无悬挂状态

package/templates/patterns//347/272/246/346/235/237/345/256/236/347/216/260/350/247/204/350/214/203.md

@@ -1,45 +0,0 @@
----
-name: constrained-implementation
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-pattern-constrained-implementation
-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: ["编码实现","写代码","修改代码","代码变更","实现","编码","coding","代码修改","修bug","修代码"]
----
-
-## 决策规则
-- 必须在修改代码前定位根因，解释根因、修改边界和验证方式后再编码
-- 只修改任务卡/补丁计划/白名单明确范围内的文件
-- 禁止补丁叠补丁或试错式堆叠修复
-- 禁止删除断言、放宽测试、增加 sleep、让测试适应错误行为
-- 禁止顺手重构或范围外的"清理"
-- 每个代码变更必须追溯到任务卡、补丁计划或阻塞性缺陷
-- 范围超出白名单或需要变更接口/DDL/权限/菜单时，立即上报而非自行决定
-- 必须完成本地验证并产出结构化证据后再结束
-- 唯一约束必须同时在数据库和应用层校验，防止并发场景下的重复数据
-- 外键约束在微服务架构中不建议使用物理外键，应通过应用层保证数据一致性
-- 乐观锁必须使用 version 字段而非 update_time（后者可能因精度问题失效）
-- 软删除数据必须排除在唯一约束之外（如添加 is_deleted 条件索引）
-- 数据库约束的校验失败必须返回用户友好的错误消息，而非数据库原始报错
-
-## 验收项
-- [AC-01] 变更范围与白名单完全匹配
-- [AC-02] 根因已确认再编码（非先改再试）
-- [AC-03] 无顺手重构或范围外变更
-- [AC-04] 本地验证执行完毕有结果
-- [AC-05] 超范围变更已上报
-- [AC-06] 唯一约束双层校验
-- [AC-07] 乐观锁用 version 字段
-- [AC-08] 软删除与唯一约束兼容

package/templates/patterns//347/274/223/345/255/230/347/255/226/347/225/245/350/247/204/350/214/203.md

@@ -1,43 +0,0 @@
----
-name: caching
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-caching
-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: ["缓存策略","缓存","cache","Redis","热点数据","查询优化","缓存穿透","缓存雪崩","@Cacheable","缓存一致性"]
----
-
-## 决策规则
-- 所有缓存必须设置 TTL，禁止永久缓存
-- 热点数据 TTL 必须加随机偏移防止雪崩
-- 缓存 key 格式必须统一：模块:业务:id
-- 查询不存在的数据必须缓存空值或使用布隆过滤器防止穿透
-- 写操作必须同步更新或失效缓存，保证一致性
-- 缓存重建必须使用分布式锁或 singleflight 模式，防止缓存击穿导致 DB 过载
-- 缓存值禁止存储大对象（建议 ≤ 1MB），大对象应只缓存 key 引用
-- 缓存操作必须设置超时时间，防止 Redis 阻塞拖垮业务线程
-- 禁止缓存中存储敏感信息（密码、token、身份证号），或必须加密后存储
-- 缓存命中率必须纳入监控，命中率低于阈值时触发告警
-- 本地缓存（Caffeine/Guava）与分布式缓存的数据一致性策略必须明确
-
-## 验收项
-- [AC-01] 所有缓存 key 有 TTL
-- [AC-02] 热点数据 TTL 加随机偏移
-- [AC-03] 缓存 key 格式统一
-- [AC-04] 有穿透/雪崩防护措施
-- [AC-05] 缓存重建有分布式锁保护
-- [AC-06] 缓存值不超过 1MB
-- [AC-07] 缓存操作有超时设置
-- [AC-08] 缓存中无明文敏感信息
-- [AC-09] 缓存命中率有监控告警

package/templates/patterns//347/274/226/347/240/201/350/264/250/351/207/217/350/247/204/350/214/203.md

@@ -1,44 +0,0 @@
----
-name: coding-quality
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-pattern-coding-quality
-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: ["编码质量","代码规范","代码评审","代码质量","重构","over-engineering","过度设计","代码异味"]
----
-
-## 决策规则
-- 50 行能解决的问题禁止写 200 行；禁止为单次使用场景过度设计
-- 每行代码变更必须可追溯到任务卡片中的显式需求，禁止"顺手"重构相邻代码
-- 实现记录必须显式声明业务入口集成状态（菜单/路由/权限）
-- Bug 修复必须针对根因，禁止在破损代码上叠加 workaround
-- 方法必须按业务步骤拆分为单一职责的私有方法
-- 新增/修改类必须文档化业务职责、边界和关键协作者
-- 仅在"非显而易见"的关键行添加注释说明 why，禁止对简单赋值加噪声注释
-- 方法长度不超过 80 行，超过时拆分为子方法
-- 方法参数不超过 5 个，超过时封装为请求对象
-- 单个类职责单一（SRP），超过 500 行的类应考虑拆分
-- 条件嵌套不超过 3 层，超过时使用卫语句、策略模式或 Optional 链重构
-- 禁止使用魔法数字，必须提取为命名常量或枚举
-
-## 验收项
-- [AC-01] 代码变更可追溯到任务需求
-- [AC-02] 业务入口集成状态已声明
-- [AC-03] Bug 修复针对根因而非 workaround
-- [AC-04] 无过度设计（50行能解决的不写200行）
-- [AC-05] 方法不超过 80 行
-- [AC-06] 参数不超过 5 个
-- [AC-07] 嵌套不超过 3 层
-- [AC-08] 无魔法数字

package/templates/patterns//347/274/272/351/231/267/347/256/241/347/220/206/350/247/204/350/214/203.md

@@ -1,43 +0,0 @@
----
-name: defect-management
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-pattern-defect-management
-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: ["缺陷管理","Bug修复","缺陷闭环","回归测试","缺陷预防","缺陷归因","质量改进"]
----
-
-## 决策规则
-- 每个缺陷必须归因到最小责任阶段（需求/设计/任务拆解/实现/测试/门禁）
-- 修复必须附带证据，"理论上修好了"不可接受
-- 有复现价值的缺陷必须产出至少一项回填动作：规则、模版、检查项或知识条目
-- 同一缺陷若在案例库中已出现过，自动升级为深层缺陷（方法论级别）
-- 报告必须在修复之前编写，禁止先改规则后写报告
-- 缺陷结论必须区分：已完成 / 未完成 / 未验证 / 未知，无真实证据不得标记为已完成
-- 缺陷必须包含完整的复现步骤、预期结果、实际结果和环境信息
-- 每个缺陷必须有优先级（P0-P4）和严重程度（S1-S4）分类
-- 修复缺陷必须包含根因分析，禁止只修表面症状
-- P0/P1 缺陷修复后必须经过回归测试，不能直接上线
-- 缺陷关闭必须由提单人确认，修复人不能自行关闭
-
-## 验收项
-- [AC-01] 缺陷有归因阶段
-- [AC-02] 修复附带执行证据
-- [AC-03] 有复现价值的缺陷有回填动作
-- [AC-04] 结论区分已完成/未完成/未验证/未知
-- [AC-05] 缺陷有完整复现信息
-- [AC-06] 有优先级和严重程度
-- [AC-07] 修复包含根因分析
-- [AC-08] 高优先级缺陷有回归测试

package/templates/patterns//350/260/203/350/257/225/346/226/271/346/263/225/350/256/272.md

@@ -1,41 +0,0 @@
----
-name: debugging-methodology
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-pattern-debugging-methodology
-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: ["调试","debug","排查问题","修复Bug","定位错误","根因分析","排障","故障排查"]
----
-
-## 决策规则
-- 一次只验证一个假设，一次只改一个变量，记录所有结果包括被否定的假设
-- 禁止从观察直接跳到修复，必须经过假设验证
-- 修复范围只覆盖确认的根因，禁止顺手改其他代码
-- 同一现象修复失败 3 次后停止猜测，重新审视假设，考虑是否为架构问题而非 Bug
-- 使用 RED-GREEN 回归验证：回退修复 → 确认失败 → 恢复修复 → 确认通过
-- 禁止通过删除断言、增加 sleep、降低覆盖率、增加 mock 来制造通过
-- 调试必须先复现问题（确定环境、数据、步骤），禁止在未复现的情况下猜测修改
-- 必须使用二分法定位问题范围（注释一半代码/回退一半提交），禁止全量排查
-- 线上问题排查必须优先查看日志和监控，禁止直接登录服务器修改代码
-- 修复后必须验证根因是否消除，而非只验证症状消失
-
-## 验收项
-- [AC-01] 调试过程有假设-验证记录
-- [AC-02] 修复范围仅限确认的根因
-- [AC-03] 3次失败后重新审视假设
-- [AC-04] 使用 RED-GREEN 回归验证
-- [AC-05] 先复现再排查
-- [AC-06] 使用二分法定位
-- [AC-07] 修复后验证根因消除