soloforge 1.1.42 → 1.1.44

package/templates/patterns//345/245/221/347/272/246/345/205/274/345/256/271/350/247/204/350/214/203.md

@@ -1,40 +0,0 @@
----
-name: contract-compatibility
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-contract-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: ["接口变更","API变更","合同变更","接口兼容","向后兼容","废弃接口","版本迁移"]
----
-
-## 决策规则
-- API 契约是前后端对齐的唯一信源，每次变更必须有 diff 记录和版本说明
-- 变更必须前向兼容，破坏性变更必须标记 deprecated 并提供至少一个完整版本的过渡期
-- 新增必填请求字段、删除字段、改变字段类型、修改路径、改变错误码含义均为破坏性变更，需要废弃流程
-- 每次契约变更必须同步更新接口文档和 schema 定义
-- 禁止前后端口头约定替代正式契约变更
-- 新增可选字段必须设默认值，保证旧客户端兼容
-- 枚举类型新增值必须评估对所有消费方的影响
-- 删除字段必须分阶段：先标记 @Deprecated → 确认无消费方 → 下版本移除
-- 数据库字段变更必须兼容旧代码（先加新字段 → 迁移数据 → 再删旧字段）
-- API 路径变更必须保留旧路径并重定向，给予消费方充足迁移时间
-
-## 验收项
-- [AC-01] 接口变更有 diff 记录
-- [AC-02] 破坏性变更有 deprecated 过渡期
-- [AC-03] 文档与 schema 同步更新
-- [AC-04] 无口头约定的非正式变更
-- [AC-05] 新字段有默认值
-- [AC-06] 删除字段分阶段进行
-- [AC-07] 数据库变更兼容旧代码

package/templates/patterns//345/256/232/346/227/266/344/273/273/345/212/241/350/247/204/350/214/203.md

@@ -1,37 +0,0 @@
----
-name: scheduled-task
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-scheduled-task
-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: ["定时任务","异步任务","cron","调度","@Scheduled","异步执行","重试","延迟任务","周期任务","后台任务","定时执行"]
----
-
-## 决策规则
-- 多实例部署的定时任务必须使用分布式锁，禁止裸 @Scheduled
-- 每次执行必须记录状态（开始/结束时间、结果、错误信息）
-- 执行失败必须有告警通知（钉钉/邮件/Slack）
-- 任务执行时间不得超过调度间隔的一半，防止堆积
-- 失败任务必须有重试机制（建议最多 3 次）
-- 定时任务必须配置超时时间，防止任务卡死影响后续调度
-- 定时任务禁止使用固定间隔执行长事务，必须拆分为小批次处理
-- 定时任务必须有手动触发入口（管理后台或 API），便于紧急修复数据
-
-## 验收项
-- [AC-01] 分布式锁防重复执行
-- [AC-02] 每次执行记录状态
-- [AC-03] 失败有告警通知
-- [AC-04] 执行时间不超调度间隔一半
-- [AC-05] 任务有超时配置
-- [AC-06] 有手动触发入口

package/templates/patterns//345/256/236/346/227/266/346/216/250/351/200/201/350/247/204/350/214/203.md

@@ -1,46 +0,0 @@
----
-name: websocket-realtime
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-pattern-websocket-realtime
-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: ["WebSocket","实时推送","实时通知","在线状态","即时通讯","SSE","Server-Sent Events","消息推送","长连接"]
----
-
-## 决策规则
-- WebSocket 连接必须有心跳机制（建议 30s），检测断线并自动重连
-- 重连必须使用指数退避策略（1s/2s/4s/8s/max 30s），禁止无限重试
-- 消息必须有序号或时间戳，消费端处理乱序和去重
-- 连接异常断开时，未确认消息必须有补偿机制（重新拉取 / 离线消息队列）
-- 后端推送频率必须有熔断保护，防止消息风暴压垮客户端
-- 单向推送优先使用 SSE（更简单），双向通信才使用 WebSocket
-- 生产环境 WebSocket 必须通过 Nginx 反向代理，配置超时和连接数限制
-- 前端组件卸载时必须关闭 WebSocket 连接，防止内存泄漏
-- WebSocket 连接必须有自动重连机制（指数退避策略），断线后自动恢复
-- 推送消息必须携带消息 ID 和时间戳，支持客户端去重和排序
-- 服务端必须实现消息缓冲，用户短暂离线后重连可获取未读消息
-- 推送消息体必须精简（≤ 4KB），大数据通过接口拉取，不通过推送传输
-- 必须支持优雅降级（WebSocket → SSE → 轮询），兼容不同网络环境
-
-## 验收项
-- [AC-01] 有心跳和自动重连机制
-- [AC-02] 重连使用指数退避
-- [AC-03] 消息有去重处理
-- [AC-04] 组件卸载关闭连接
-- [AC-05] 未确认消息有补偿机制
-- [AC-06] 自动重连机制
-- [AC-07] 消息去重和排序
-- [AC-08] 离线消息缓冲
-- [AC-09] 降级策略（WS→SSE→轮询）

package/templates/patterns//345/267/245/347/250/213/347/272/252/345/276/213.md

@@ -1,52 +0,0 @@
----
-name: engineering-discipline
-scope:
-  - backend
-  - frontend
-products:
-  - '*'
-id: ka-pattern-engineering-discipline
-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: ["工程纪律","工作原则","开发原则","证据优先","变更追溯","缺陷预防","设计落地","推论与事实"]
----
-
-## 决策规则
-- 每行代码变更必须可追溯到任务卡片、设计决策或缺陷根因，禁止无来源的孤立变更
-- 解释不替代证据，"理论上修好了"不可接受，必须有执行证据
-- 推论不得冒充事实，必须显式区分已确认事实、推论和未知项
-- 未知项必须显式记录并跟进，禁止静默跳过
-- 规则只从真实缺陷中提取，禁止凭空捏造预防性规则
-- 复发缺陷必须产出至少一条规则或检查项（防复发闭环）
-- 设计必须提供可实施锚点（数据结构、接口定义、状态机），禁止只给抽象原则
-- 先验证后判断，禁止先下结论再找理由
-- 一级证据（运行时、真实部署、真实浏览器）优先于二级文档，禁止用 dry-run/静态分析/AI 摘要冒充运行时证据
-- 根因定位先于代码修改，禁止试错式补丁叠补丁
-- 自动修复循环上限 3 轮，同一错误 >=2 次触发回填，>=4 次记录为复发缺陷
-- 超出范围边界时立即上报，禁止自行决定扩范围
-- 编译告警必须全部处理，禁止忽略（设置 -Werror 或 CI 编译告警数阈值）
-- 代码提交前必须本地通过编译和单元测试，禁止把明显错误提交到远端
-- 依赖升级必须逐个进行并验证，禁止批量升级多个依赖
-- 线上配置变更必须通过配置中心（Nacos/Apollo），禁止直接修改配置文件重启
-- 每次发布必须有回滚方案和验证清单，不能"改了就上线"
-
-## 验收项
-- [AC-01] 代码变更可追溯到任务或缺陷
-- [AC-02] 推论与事实有显式区分标记
-- [AC-03] 缺陷修复有执行证据
-- [AC-04] 复发缺陷有防复发规则
-- [AC-05] 运行时证据替代 dry-run/AI 摘要
-- [AC-06] 自动修复循环未超过 3 轮
-- [AC-07] 超范围变更有上报记录
-- [AC-08] 编译告警全部处理
-- [AC-09] 提交前本地验证
-- [AC-10] 依赖逐个升级
-- [AC-11] 发布有回滚方案

package/templates/patterns//345/271/266/345/217/221/346/216/247/345/210/266/350/247/204/350/214/203.md

@@ -1,46 +0,0 @@
----
-name: concurrency-control
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-concurrency-control
-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: ["并发控制","并发","锁","乐观锁","悲观锁","分布式锁","竞态条件","超卖","库存扣减","重复提交","原子操作","幂等","去重"]
----
-
-## 决策规则
-- 涉及金额、库存、配额、计数器等可变共享状态的操作必须显式声明并发控制策略
-- 乐观锁适用于读多写少场景（版本号字段 + CAS），悲观锁适用于写多竞争激烈场景（SELECT FOR UPDATE）
-- 分布式环境必须使用分布式锁（Redis SETNX / Redisson / ZooKeeper），禁止依赖 JVM 级锁跨实例
-- 锁粒度必须最小化：锁具体资源而非整个表，锁业务 ID 而非全局锁
-- 分布式锁必须设置超时时间（防止死锁），建议默认 30 秒
-- 幂等方案优先于加锁：唯一约束、去重表、Token 机制比分布式锁更可靠
-- 超卖/超扣场景必须使用数据库原子操作（UPDATE SET stock = stock - 1 WHERE stock >= 1），禁止先查后改
-- 乐观锁冲突必须有用户可见提示（"数据已被修改，请刷新重试"），禁止静默失败
-- 批量并发操作必须限制并发度（信号量/线程池），禁止无限制并发
-- ThreadLocal 必须在请求结束时 remove()，否则线程池复用导致数据串线
-- 锁的获取和释放必须在同一个 try-finally 块中，防止异常导致死锁
-- 分布式锁必须设置过期时间（如 30s），防止持有者崩溃导致永久死锁
-- 原子操作优先使用 CAS（AtomicInteger/LongAdder），无竞争场景性能优于锁
-- 线程池必须通过 ThreadPoolExecutor 构造函数创建，禁止使用 Executors（避免 OOM）
-
-## 验收项
-- [AC-01] 共享可变状态操作有显式并发控制策略
-- [AC-02] 分布式锁有超时设置
-- [AC-03] 超卖场景使用原子操作而非先查后改
-- [AC-04] 乐观锁冲突有用户提示
-- [AC-05] 批量并发操作有并发度限制
-- [AC-06] ThreadLocal 请求结束清理
-- [AC-07] 锁释放 try-finally 保护
-- [AC-08] 分布式锁有超时时间
-- [AC-09] 线程池显式创建

package/templates/patterns//345/274/202/346/255/245/345/257/274/345/207/272/350/247/204/350/214/203.md

@@ -1,39 +0,0 @@
----
-name: async-export
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-async-export
-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: ["异步导出","数据导出","批量导出","报表导出","CSV","Excel","PDF","下载","文件导出","导出功能"]
----
-
-## 决策规则
-- 超过 1000 条数据必须走异步导出，返回任务 ID
-- 异步导出任务必须有状态追踪（PENDING/PROCESSING/COMPLETED/FAILED）
-- 导出文件必须存储在对象存储，禁止堆积在本地磁盘
-- 导出文件必须设置过期时间（建议 24 小时），到期自动清理
-- 导出文件必须包含表头行，字段名对齐业务术语
-- 大数据量导出必须异步执行，通过 WebSocket/轮询通知完成状态
-- 导出数据量必须有上限（如单次 ≤ 100 万行），超限提示用户缩小范围
-- 导出过程必须有进度反馈（已完成 X/Y 条），提升用户体验
-- 导出失败必须通知用户并提供重试机制
-
-## 验收项
-- [AC-01] 大数据量走异步导出返回任务 ID
-- [AC-02] 任务有状态追踪
-- [AC-03] 文件 24 小时内自动清理
-- [AC-04] 导出文件含表头行
-- [AC-05] 大导出异步执行并有通知
-- [AC-06] 导出文件有过期清理
-- [AC-07] 有进度反馈

package/templates/patterns//346/216/245/345/217/243/345/245/221/347/272/246/350/247/204/350/214/203.md

@@ -1,42 +0,0 @@
----
-name: interface-contract
-scope:
-  - backend
-products:
-  - '*'
-id: ka-pattern-interface-contract
-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: ["接口文档","API文档","接口契约","Swagger","接口定义","接口规范","字段定义","接口评审"]
----
-
-## 决策规则
-- 每个接口必须有完整定义：路径、方法、认证、请求、响应、错误码
-- 页面交互与接口必须有映射表确保一一对应
-- 每个接口至少定义：校验失败、权限不足、业务异常、资源不存在四种错误
-- 所有枚举字段必须列出完整值集和含义，禁止无枚举定义的 type/status/flag 字段
-- 每个接口必须显式声明幂等性和认证属性
-- 接口契约中鉴权要求必须能回链到角色与权限模型
-- 接口文档必须与代码同步更新，禁止文档与实现不一致
-- 破坏性变更必须通过版本号隔离（如 /v1/ → /v2/），保证旧客户端兼容
-- 接口响应时间必须有 SLA 约定（如 P99 < 500ms），超时触发告警
-- 接口必须定义错误码体系（业务错误码 + HTTP 状态码），客户端可区分处理
-- 接口变更必须通知所有消费方，并给予充足的迁移时间
-
-## 验收项
-- [AC-01] 接口文档包含完整定义（路径/方法/认证/请求/响应/错误）
-- [AC-02] 页面交互与接口有映射表
-- [AC-03] 枚举字段有完整值集定义
-- [AC-04] 接口声明了幂等性和认证属性
-- [AC-05] 文档与代码同步
-- [AC-06] 破坏性变更版本隔离
-- [AC-07] 有 SLA 约定和监控
-- [AC-08] 错误码体系完整

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 修复有回归测试