soloforge 1.1.2 → 1.1.31

package/templates/knowledge/acceptance_templates//346/225/205/351/232/234/345/244/215/347/233/230/346/250/241/347/211/210.md

@@ -1,53 +0,0 @@
----
-name: 故障复盘模版
-type: acceptance_template
-when: 故障复盘, 事故复盘, postmortem, P0复盘, 线上事故复盘
-scope: [backend, frontend]
-products: ["*"]
----
-
-# 故障复盘报告
-
-## 1. 故障概要
-- **发生时间**：
-- **持续时间**：
-- **影响范围**（用户数/业务量）：
-- **严重程度**：P0/P1
-- **处理人**：
-
-## 2. 时间线
-| 时间 | 事件 | 操作人 |
-|------|------|--------|
-| | 发现问题 | |
-| | 通知干系人 | |
-| | 执行止血 | |
-| | 定位根因 | |
-| | 部署修复 | |
-| | 确认恢复 | |
-
-## 3. 根因分析
-- **直接原因**：
-- **深层原因**（5 Whys）：
-  1. 为什么发生？
-  2. 为什么没被发现？
-  3. 为什么没被阻止？
-  4. 为什么监控没告警？
-  5. 系统性原因是什么？
-
-## 4. 修复过程
-- 止血方案：
-- 最终修复：
-- 修复验证结果：
-
-## 5. 暴露的监控盲区
-| 监控项 | 当前状态 | 改进方案 | 计划完成时间 |
-|--------|---------|---------|------------|
-| | | | |
-
-## 6. 后续改进项
-| 编号 | 改进项 | 类型 | 责任人 | 计划时间 |
-|------|--------|------|--------|---------|
-| | 补监控 | 防复发 | | |
-| | 补测试 | 防复发 | | |
-| | 更新知识条目 | 流程 | | |
-| | 架构优化 | 根治 | | |

package/templates/knowledge/acceptance_templates//346/225/260/346/215/256/345/272/223/345/217/230/346/233/264/346/226/271/346/241/210/346/250/241/347/211/210.md

@@ -1,45 +0,0 @@
----
-name: 数据库变更方案模版
-type: acceptance_template
-when: 数据库变更方案, DDL变更, 表结构变更方案, migration方案
-scope: [backend]
-products: ["*"]
----
-
-# 数据库变更方案
-
-## 1. 变更概述
-- 变更类型：加列 / 改列 / 删列 / 加索引 / 新建表 / 数据迁移
-- 涉及表：
-- 变更原因：
-
-## 2. 变更详情
-### 正向 DDL
-```sql
--- 正向 migration
-```
-
-### 回滚 DDL
-```sql
--- 回滚 migration
-```
-
-## 3. 兼容性分析
-| 层级 | 影响 | 兼容策略 |
-|------|------|---------|
-| 数据库 | | |
-| 接口契约 | | |
-| 前端展示 | | |
-| 导出逻辑 | | |
-
-## 4. 数据迁移方案（如需要）
-- 数据量评估：
-- 分批策略（每批条数/间隔）：
-- 预计耗时：
-- 数据校验方式：
-
-## 5. 执行计划
-- 大表评估（>100万行）：
-- 执行时间窗口（低峰期）：
-- 备份方案：
-- 监控告警：

package/templates/knowledge/acceptance_templates//346/225/260/346/215/256/345/272/223/345/217/230/346/233/264/351/252/214/346/224/266/346/270/205/345/215/225.md

@@ -1,24 +0,0 @@
----
-name: database-change
-type: acceptance_template
-when: 数据库变更, 表结构修改, migration, DDL, 加字段, 建表, 索引, 数据迁移, 表结构变更
-scope: [backend]
-products: ["*"]
----
-
-## 验收项
-- [AC-01] migration 脚本有对应回滚脚本 (check: ls U{version}__*.sql {dir})
-- [AC-02] migration 脚本幂等（可重复执行不出错） (check: grep -c 'IF NOT EXISTS\|IF EXISTS' {file})
-- [AC-03] 新增列有默认值或允许 NULL（向前兼容） (check: grep 'ALTER TABLE.*ADD COLUMN' {file} | grep -c 'DEFAULT\|NULL')
-- [AC-04] migration 脚本无业务逻辑（无 SELECT/INSERT/UPDATE 业务数据） (check: grep -ic 'INSERT INTO\|UPDATE.*SET' {file})
-- [AC-05] 大数据量迁移使用分批策略（每批 1000 条） (check: grep -c 'LIMIT.*OFFSET\|BATCH\|分批\|batchSize' {file})
-- [AC-06] 禁止 DROP COLUMN（应标记 deprecated 后续清理） (check: grep -ic 'DROP COLUMN\|DROP TABLE' {file})
-- [AC-07] 新建索引评估对大表的影响（>100 万行使用 ONLINE DDL） (check: grep -c 'ONLINE\|ALGORITHM\|pt-online' {file})
-- [AC-08] 字段命名遵循项目约定（snake_case，无缩写歧义） (check: grep -P '[A-Z]' {file} | grep -v '^\s*--' | head -5)
-- [AC-09] 迁移脚本是否向前兼容（先加列后删列，先加索引后删除旧索引） (check: grep -c 'ADD.*COLUMN\|ADD.*INDEX' {file})
-- [AC-10] 是否有回滚脚本并在测试环境验证通过 (check: ls {dir}/rollback_*.sql {dir}/down_*.sql 2>/dev/null | wc -l)
-- [AC-11] 新增字段是否有默认值（非 NULL 列必须有 DEFAULT） (check: grep 'ADD COLUMN' {file} | grep -cv 'DEFAULT\|NULL')
-- [AC-12] 新增索引是否评估对写入性能的影响（大表需评审） (check: grep -c 'CREATE.*INDEX\|ADD.*INDEX' {file})
-- [AC-13] 大表变更是否使用 ONLINE DDL（避免锁表） (check: grep -c 'ALGORITHM.*INPLACE\|ALGORITHM.*ONLINE\|pt-online\|ONLINE' {file})
-- [AC-14] 数据迁移脚本是否有数据校验步骤（迁移前后行数对比/哈希校验） (check: grep -c 'COUNT(\*)\|checksum\|MD5\|SHA\|校验\|验证' {file})
-- [AC-15] 迁移脚本是否纳入版本控制（Git tracked） (check: git ls-files {file} | wc -l)

package/templates/knowledge/acceptance_templates//346/236/266/346/236/204/350/256/276/350/256/241/346/250/241/347/211/210.md

@@ -1,42 +0,0 @@
----
-name: 架构设计模版
-type: acceptance_template
-when: 架构设计, 模块设计, 系统设计, 技术方案
-scope: [backend, frontend]
-products: ["*"]
----
-
-# 架构设计文档
-
-## 1. 需求概要
-- 业务背景：
-- 核心需求：
-- 非功能需求（性能/安全/可用性）：
-
-## 2. 模块划分
-- 模块清单与职责边界
-- 模块间依赖关系图
-- 核心接口契约（模块间调用方式）
-
-## 3. 数据流向
-- 主流程数据流向图
-- 关键数据结构定义
-- 数据存储方案（数据库/缓存/文件）
-
-## 4. 技术选型与依据
-| 技术决策 | 候选方案 | 最终选择 | 选择理由 | 放弃方案原因 |
-|---------|---------|---------|---------|------------|
-|         |         |         |         |            |
-
-## 5. 状态机定义
-- 核心业务状态流转
-- 触发条件、守卫条件、失败/回滚动作
-
-## 6. 风险点与应对
-| 风险 | 影响 | 概率 | 应对方案 |
-|------|------|------|---------|
-|      |      |      |         |
-
-## 7. 扩展点
-- 已识别的未来扩展方向
-- 预留的扩展机制（接口/配置/插件）

package/templates/knowledge/acceptance_templates//346/265/213/350/257/225/350/256/241/345/210/222/346/250/241/347/211/210.md

@@ -1,39 +0,0 @@
----
-name: 测试计划模版
-type: acceptance_template
-when: 测试计划, 验证计划, 测试策略, 测试规划
-scope: [backend, frontend]
-products: ["*"]
----
-
-# 测试计划
-
-## 1. 测试范围
-- 关联任务卡片：
-- 测试目标（验证哪些功能点）：
-- 不在测试范围内的事项：
-
-## 2. 测试条目
-| 编号 | 功能点 | 测试类型 | 覆盖策略 | 关联任务卡 | 优先级 |
-|------|--------|---------|---------|-----------|--------|
-| T-01 | 正常流程 | 集成测试 | 正常路径 | | P0 |
-| T-02 | 参数缺失 | 单元测试 | 错误路径 | | P0 |
-| T-03 | 权限不足 | 集成测试 | 错误路径 | | P0 |
-| T-04 | 边界值 | 单元测试 | 边界场景 | | P1 |
-
-## 3. 环境与数据
-- 测试环境：
-- 数据准备方式（业务API/页面操作/SQL初始化脚本）：
-- 前置依赖（DDL迁移/配置项/第三方Mock）：
-
-## 4. 执行顺序
-1. DDL 迁移验证
-2. 单元测试
-3. 集成测试
-4. 端到端测试
-
-## 5. 验收标准
-- [ ] 所有 P0 测试条目通过
-- [ ] 所有 P1 测试条目通过
-- [ ] 高风险变更有运行时验证
-- [ ] DDL 变更有回滚验证

package/templates/knowledge/acceptance_templates//350/257/246/347/273/206/350/256/276/350/256/241/346/250/241/347/211/210.md

@@ -1,40 +0,0 @@
----
-name: 详细设计模版
-type: acceptance_template
-when: 详细设计, 模块内部设计, 实现设计
-scope: [backend, frontend]
-products: ["*"]
----
-
-# 详细设计文档
-
-## 1. 设计前提
-- 对接的架构设计文档：
-- 依赖的接口/模块：
-
-## 2. 数据结构（DDL/Model）
-- 表结构定义（字段名、类型、约束、注释、默认值）
-- 实体关系图
-- 索引策略
-- 审计字段（create_time/update_time/create_by/update_by）
-
-## 3. 接口定义
-- 内部接口（模块间调用）
-- 方法签名、入参、出参、异常
-- 幂等性声明
-
-## 4. 核心逻辑
-- 状态机定义（状态、事件、守卫、动作）
-- 异常处理策略（每种异常的处理方式）
-- 并发控制方案（乐观锁/悲观锁/分布式锁/幂等键）
-- 缓存方案（缓存 key、TTL、失效策略）
-
-## 5. 前后端适配矩阵
-| 前端页面/组件 | 后端接口 | 数据字段映射 | 交互行为 |
-|-------------|---------|------------|---------|
-|             |         |            |         |
-
-## 6. 菜单权限映射
-| 菜单路径 | 角色 | 权限标识 | 关联接口 |
-|---------|------|---------|---------|
-|         |      |         |         |

package/templates/knowledge/acceptance_templates//350/277/201/347/247/273/350/257/204/344/274/260/346/250/241/347/211/210.md

@@ -1,42 +0,0 @@
----
-name: 迁移评估模版
-type: acceptance_template
-when: 迁移评估, 技术迁移, 框架升级, 系统迁移评估
-scope: [backend, frontend]
-products: ["*"]
----
-
-# 迁移评估报告
-
-## 1. 迁移范围
-- 当前技术/版本：
-- 目标技术/版本：
-- 涉及模块数/代码量：
-- 依赖链影响范围：
-
-## 2. 兼容性分析
-| 变更项 | 当前 | 目标 | 兼容性 | 适配方案 |
-|--------|------|------|--------|---------|
-| API 变更 | | | | |
-| 配置变更 | | | | |
-| 行为差异 | | | | |
-| 依赖冲突 | | | | |
-
-## 3. 迁移路径
-- **推荐路径**：渐进式 / 一次性
-- **阶段划分**：
-| 阶段 | 内容 | 预计工时 | 回滚方案 |
-|------|------|---------|---------|
-| 1 | | | |
-| 2 | | | |
-
-## 4. 风险评估
-- 高风险点：
-- 兼容层需求（适配器/Shim/Feature Flag）：
-- 数据迁移需求：
-- 回滚方案：
-
-## 5. 资源与时间
-- 所需人力/技能：
-- 建议时间窗口：
-- 灰度策略：

package/templates/knowledge/acceptance_templates//351/200/232/347/224/250/350/264/250/351/207/217/351/252/214/346/224/266/346/270/205/345/215/225.md

@@ -1,30 +0,0 @@
----
-name: general-quality
-type: acceptance_template
-when: 代码质量, 代码审查, review, 质量检查, 提交检查, 上线前检查, 代码评审
-scope: [backend, frontend]
-products: ["*"]
----
-
-## 验收项
-- [AC-01] 无 SQL 字符串拼接（使用参数化查询或 ORM） (check: grep -E '(SELECT|INSERT|UPDATE|DELETE).*(\+|\$\{|%s)' {file})
-- [AC-02] 无 eval/Function 动态代码执行 (check: grep -c '\beval\s*(\|new Function\s*(' {file})
-- [AC-03] 前端无 innerHTML 赋值（防 XSS） (check: grep -c '\.innerHTML\s*=' {file})
-- [AC-04] 无循环内数据库调用（防 N+1） (check: grep -B3 '\.save\|\.insert\|\.update\|\.query\|\.select' {file} | grep -c 'for\|while')
-- [AC-05] 无硬编码的敏感信息（密码/密钥/token） (check: grep -ic 'password\s*=\s*["\x27]\|secret\s*=\s*["\x27]\|token\s*=\s*["\x27]' {file})
-- [AC-06] 文件不超过 500 行（超过应拆分） (check: wc -l {file})
-- [AC-07] 无未处理的 TODO/FIXME 标记（或已记录为技术债务） (check: grep -c 'TODO\|FIXME\|HACK\|XXX' {file})
-- [AC-08] 编译无错误和警告 (check: npm run build 2>&1 | grep -c 'error\|warning')
-- [AC-09] 单元测试覆盖核心逻辑 (check: ls *Test.java *Test.tsx *.test.ts *.spec.ts {dir} 2>/dev/null | wc -l)
-- [AC-10] 接口变更同步更新了文档或契约定义 (check: grep -c 'swagger\|openapi\|ApiOperation\|@Api' {file})
-- [AC-11] 单元测试覆盖率是否达标（核心逻辑 ≥ 80%） (check: grep -r 'coverage\|覆盖率' {dir} | head -3)
-- [AC-12] 是否有集成测试覆盖关键业务路径 (check: ls *IT.java *IT.test.ts *e2e* {dir} 2>/dev/null | wc -l)
-- [AC-13] 是否配置了监控告警（错误率、响应时间） (check: grep -c 'alert\|告警\|metrics\|SLO\|SLA' {file})
-- [AC-14] 是否有回滚方案和验证清单 (check: grep -c 'rollback\|回滚\|revert' {file})
-- [AC-15] 技术文档是否更新（接口文档、架构文档） (check: git diff --name-only {base}..HEAD | grep -c 'README\|CHANGELOG\|doc')
-- [AC-16] 性能是否满足 SLA 要求（P99 响应时间、吞吐量） (check: grep -c 'performance\|SLA\|P99\|latency\|benchmark' {file})
-- [AC-17] 日志是否包含 traceId 支持链路追踪 (check: grep -c 'traceId\|trace_id\|TraceId\|MDC\|correlationId' {file})
-- [AC-18] 交付物末尾已签署终局宣言 [SoloForge Audit: PASS]（机制 2: 掘地三尺契约）
-- [AC-19] 验收项覆盖边界场景（空值/极端值/异常输入），非仅 happy path（机制 2: 三重否定推演）
-- [AC-20] 涉及外部调用时验收项包含超时/异常格式/降级场景（机制 2: 链路否定）
-- [AC-21] 测试断言精确度达标（精确断言率 >= 50%），无"自己证明自己"问题（机制 4: 变异防造假）

package/templates/knowledge/acceptance_templates//351/207/215/346/236/204/346/226/271/346/241/210/346/250/241/347/211/210.md

@@ -1,47 +0,0 @@
----
-name: 重构方案模版
-type: acceptance_template
-when: 重构方案, 代码重构, 模块重构, 结构优化
-scope: [backend, frontend]
-products: ["*"]
----
-
-# 重构方案文档
-
-## 1. 重构动机
-- 当前问题（坏味道描述 + 量化数据）：
-- 不重构的长期风险：
-
-## 2. 重构目标
-- 目标状态描述：
-- 可衡量的改善指标（圈复杂度/行数/类数）：
-
-## 3. Before/After 对比
-### Before（当前结构）
-- 类/方法职责描述
-- 调用关系图
-- 关键度量（行数、分支数）
-
-### After（重构后结构）
-- 类/方法职责描述
-- 调用关系图
-- 关键度量（预期行数、分支数）
-
-## 4. 实施步骤
-| 步骤 | 变更内容 | 可独立验证 | 回滚方式 |
-|------|---------|-----------|---------|
-| 1 | | | |
-| 2 | | | |
-
-## 5. 风险评估
-- 影响范围（受影响的接口/模块/测试）：
-- 行为等价性保障（如何确认不改变外部行为）：
-- 回滚策略：
-
-## 6. 质量保障检查
-- [ ] 重构是否保持功能等价（有测试用例保障）
-- [ ] 是否分阶段执行（可增量发布，每阶段独立验证）
-- [ ] 是否有回滚方案（每阶段独立可回滚）
-- [ ] 重构是否清理了遗留的 TODO 和临时代码
-- [ ] 重构后性能是否有回归测试（基准对比）
-- [ ] 是否更新了相关文档和注释

package/templates/knowledge/acceptance_templates//351/234/200/346/261/202/345/210/206/346/236/220/346/250/241/347/211/210.md

@@ -1,44 +0,0 @@
----
-name: 需求分析模版
-type: acceptance_template
-when: 需求分析, 需求梳理, 需求澄清, 需求理解
-scope: [backend, frontend]
-products: ["*"]
----
-
-# 需求分析文档
-
-## 1. 需求来源
-- 需求文档/原型链接：
-- 提出人：
-- 优先级：P0/P1/P2/P3
-
-## 2. 功能点清单
-| 编号 | 功能点 | 页面/接口 | 业务规则 | 验收标准 | 状态 |
-|------|--------|----------|---------|---------|------|
-| F-01 | | | | | 待确认/已确认 |
-
-## 3. 术语表
-| 术语 | 含义 | 同义词（统一为） |
-|------|------|----------------|
-| | | |
-
-## 4. 未确认项
-| 编号 | 问题 | 影响范围 | 阻塞程度 | 负责人 |
-|------|------|---------|---------|--------|
-| | | | 阻塞/非阻塞 | |
-
-## 5. 写操作失败反馈
-| 操作 | 失败场景 | 用户提示 | 重试建议 | 是否可恢复 |
-|------|---------|---------|---------|-----------|
-| | | | | |
-
-## 6. 菜单权限规划
-| 菜单路径 | 关联功能 | 角色 | 权限标识 | 默认可见 |
-|---------|---------|------|---------|---------|
-| | | | | |
-
-## 7. 冲突与越界项
-| 项 | 类型（冲突/越界） | 来源 | 处理方式 |
-|----|-----------------|------|---------|
-| | | | 排除/延期/升级确认 |

package/templates/knowledge/domain//345/244/232/347/247/237/346/210/267.md

@@ -1,35 +0,0 @@
----
-name: multi-tenancy
-type: domain
-when: 多租户, 租户隔离, tenant, SaaS, 租户, 数据隔离, 多客户
-scope: [backend]
-products: ["saas"]
----
-
-## 业务规则
-1. 每个租户的数据完全隔离，租户 A 不能看到租户 B 的任何数据
-2. 所有查询必须自动附加租户过滤条件，不依赖开发人员手动添加
-3. 租户切换需重新认证，不支持跨租户操作
-4. 租户级配置（功能开关、字段自定义）独立管理
-5. 租户间数据必须物理隔离（独立 schema/库）或逻辑隔离（tenant_id 字段 + 全局过滤）
-6. 租户配置（功能开关、参数）必须支持按租户覆盖全局默认值
-7. 新增租户必须自动初始化基础数据（角色、权限、默认菜单）
-
-## 约束条件
-- 数据库层面使用 tenant_id 字段实现行级隔离（共享数据库方案）
-- MyBatis 拦截器自动注入 tenant_id 条件，禁止绕过拦截器直接写 SQL
-- 新建表必须包含 tenant_id 字段并建立索引
-- 超级管理员可跨租户查看数据，但需审计日志记录
-- 租户 ID 必须在所有业务表中存在，且建立索引
-- 跨租户数据查询必须显式声明并经过审批
-- 租户数据删除必须级联清理所有关联数据
-
-## 例外情况
-- 系统级配置表（如地区、行业分类）不需要 tenant_id
-- 数据统计聚合（如系统总用户数）需脱敏处理后统计
-- 系统管理后台（超管）允许跨租户操作
-
-## 关联模式
-参见 auth-permission 模式（权限模型与租户关联）、logging 模式（日志需记录 tenantId）
-- auth-permission
-- data-privacy

package/templates/knowledge/domain//345/256/241/350/256/241/346/227/245/345/277/227.md

@@ -1,34 +0,0 @@
----
-name: audit-logging
-type: domain
-when: 审计日志, 操作日志, 审计记录, 操作记录, 变更记录, 操作追踪
-scope: [backend]
-products: ["*"]
----
-
-## 业务规则
-1. 所有关键业务操作（创建、修改、删除、导出、权限变更）必须记录审计日志
-2. 审计日志不可修改和删除，至少保留 3 年
-3. 每条审计日志包含：操作人、操作时间、操作类型、操作对象、变更前后数据
-4. 敏感操作（删除、权限变更、导出）需额外通知管理员
-5. 审计日志必须记录：操作人、操作时间、操作类型、目标对象、变更前后值
-6. 审计日志禁止被修改或删除（append-only），保证审计链完整性
-7. 审计日志查询必须支持按时间范围、操作人、操作类型、目标对象筛选
-
-## 约束条件
-- 审计日志存储在独立表中（audit_log），不与业务数据混存
-- 通过 AOP 切面自动记录，减少开发人员手动埋点
-- 变更前后数据使用 JSON 格式存储（before/after 字段）
-- 审计日志表不支持 UPDATE 和 DELETE（数据库层权限控制）
-- 审计日志必须独立存储，不能与业务数据混用同一张表
-- 审计日志保留期限必须符合合规要求（如 ≥ 180 天）
-
-## 例外情况
-- 查询操作（GET）一般不记录审计日志（除导出操作）
-- 批量操作合并为一条审计记录（含数量信息）
-- 查询类操作（GET）通常不记录审计日志，除非有特殊合规要求
-
-## 关联模式
-参见 logging 模式（日志记录规范）、error-handling 模式（异常处理与审计）
-- logging
-- data-privacy

package/templates/knowledge/domain//345/257/274/345/205/245/345/257/274/345/207/272/350/247/204/345/210/231.md

@@ -1,37 +0,0 @@
----
-name: import-export-rules
-type: domain
-when: 数据导入, 数据导出, Excel导入, CSV导入, 批量导入, 模板下载, 导入校验, 批量处理
-scope: [backend, frontend]
-products: ["*"]
----
-
-## 业务规则
-- 导入必须提供标准模板下载功能，模板字段与校验规则一一对应
-- 导入数据必须全量校验后再入库，禁止边校验边入库（部分成功部分失败难以处理）
-- 校验失败必须返回完整錙误报告（行号 + 字段名 + 錙误原因），禁止只返回"导入失败"
-- 超过 1000 条的导入必须走异步处理，返回任务 ID 和进度查询接口
-- 导入更新模式必须明确：新增/覆盖/跳过已存在记录
-- 导出字段必须与导入模板字段对齐，导入的数据可通过导出还原
-- 导入数据必须支持预览和校验，校验失败返回具体行号和错误原因
-- 导入模板必须与当前系统版本一致，字段变更时同步更新模板
-- 导出数据必须遵循数据权限规则，用户只能导出权限范围内的数据
-
-## 约束
-- 导入文件大小限制（建议 10MB），超过限制前端拦截不提交
-- 导入文件类型限制（仅允许 .xlsx/.xls/.csv），禁止 .exe/.sh 等可执行文件
-- 导入操作必须有审计日志（操作人、时间、记录数、成功/失败数）
-- 大数据量导出使用流式写入（SXSSFWorkbook），禁止全量加载到内存
-- 导入文件大小必须限制（如 ≤ 20MB），超过限制拒绝处理
-- 导入操作必须有操作日志，记录导入人、时间、记录数、成功/失败数
-
-## 例外
-- 小数据量（< 100 条）可同步导入，直接返回结果
-- 参考数据（字典、配置）导入可简化校验
-- 系统管理员导出数据可以绕过数据权限，但必须有审批流程
-
-## 关联模式
-- [[async-export]] 异步导出模式
-- [[file-upload]] 文件上传安全
-- async-export
-- input-validation

package/templates/knowledge/domain//345/267/245/344/275/234/346/265/201/345/274/225/346/223/216.md

@@ -1,37 +0,0 @@
----
-name: workflow-engine
-type: domain
-when: 审批流, 工作流, 审批, 流程引擎, 审批规则, 审批节点, 会签, 或签, 转办, 驳回, 撤回
-scope: [backend]
-products: ["*"]
----
-
-## 业务规则
-- 每个审批节点必须定义：审批人/角色、超时时间、超时自动动作（自动通过/自动驳回/升级）
-- 审批状态流转必须完整：待提交→审批中→通过/驳回/撤回/终止，禁止出现不可解释的中间状态
-- 并行审批（会签）必须定义：全部通过/一票通过/一票否决/比例通过策略
-- 驳回必须明确回到哪个节点：发起人/上一节点/指定节点
-- 审批记录必须完整保留：谁在什么时间审批了什么结果、意见是什么
-- 审批权限必须校验：只有指定的审批人可以审批，禁止越权操作
-- 工作流定义必须支持版本管理，修改后不影响已发起的流程实例
-- 流程节点必须支持超时处理（自动流转/催办/升级），防止流程卡住
-- 流程回退必须回到指定节点而非直接退回起始节点
-
-## 约束条件
-- 审批流定义与业务逻辑解耦，禁止在业务代码中硬编码审批步骤
-- 审批超时提醒必须有通知机制（站内信/邮件/钉钉）
-- 审批历史数据禁止物理删除，只能归档
-- 审批中的业务数据禁止修改（如需修改须先撤回再提交）
-- 流程变量大小必须限制（如单个变量 ≤ 4KB），防止流程引擎性能问题
-- 流程发起人必须有权限校验，不是所有用户都能发起所有流程
-
-## 例外情况
-- 紧急审批可设置简化流程（减少审批节点），但必须有事后补审机制
-- 系统管理员可查看所有审批记录，但不可代为审批
-- 紧急流程可以跳过非必要审批节点（需配置紧急通道权限）
-
-## 关联模式
-- [[state-transition]] 状态机流转
-- [[auth-permission]] 审批权限控制
-- state-flow
-- auth-permission

package/templates/knowledge/domain//346/212/245/350/241/250/347/273/237/350/256/241.md

@@ -1,36 +0,0 @@
----
-name: report-statistics
-type: domain
-when: 报表, 统计, 数据分析, 数据看板, 仪表盘, dashboard, 数据汇总, 图表, BI
-scope: [backend, frontend]
-products: ["*"]
----
-
-## 业务规则
-- 统计数据必须注明统计口径（时间范围、数据来源、计算规则、排除条件）
-- 统计维度变更必须记录历史，保证趋势数据的可比性
-- 实时看板数据必须定义刷新频率和数据延迟容忍度
-- 导出报表必须包含：生成时间、数据截止时间、统计口径说明
-- 敏感数据统计（金额、人数）必须有权限控制，禁止无权限查看汇总数据
-- 报表查询必须支持时间范围筛选，默认查询最近 30 天
-- 大数据量报表必须使用异步生成 + 下载方式，禁止同步等待
-- 报表数据必须与业务数据来源一致，禁止报表查询绕过业务逻辑直接读库
-
-## 约束条件
-- 统计查询禁止直接查询业务主表，必须使用汇总表或物化视图
-- 大时间范围统计必须支持分页或分段加载，禁止一次返回全量
-- 图表颜色方案必须统一，禁止同一报表使用不一致的配色
-- 统计接口响应时间目标 < 3 秒，超过时必须使用预计算/缓存
-- 报表生成时间超过 30 秒必须改为异步模式
-- 报表缓存必须设置过期时间，避免展示过期数据
-
-## 例外情况
-- 管理层汇总看板可使用 T+1 数据（次日更新）
-- 临时统计需求可走 SQL 直查，但须标注"非正式统计"
-- 实时看板类报表允许少量延迟（秒级），不要求强一致性
-
-## 关联模式
-- [[caching]] 统计数据缓存
-- [[n-plus-one-query]] 统计查询优化
-- caching
-- async-export

package/templates/knowledge/domain//346/224/257/344/273/230/350/247/204/345/210/231.md

@@ -1,38 +0,0 @@
----
-name: payment-rules
-type: domain
-when: 支付, 支付流程, 支付宝, 微信支付, 退款, 交易, 结算, 订单支付, 充值, 提现
-scope: [backend]
-products: ["*"]
----
-
-## 业务规则
-- 支付操作必须幂等：同一笔订单不可重复扣款，支付回调必须做幂等校验（支付流水号唯一约束）
-- 支付状态必须明确：待支付→支付中→支付成功→支付失败→已关闭，不可跳跃
-- 金额计算禁止使用浮点数，必须使用 BigDecimal 或整数分（1 元 = 100 分）
-- 退款金额不得超过实付金额，部分退款累计不得超过实付金额
-- 支付超时未支付订单必须自动关闭（建议 30 分钟），释放库存等占用资源
-- 对账机制：每日定时与第三方支付平台对账，差异记录必须有告警和人工处理流程
-- 支付金额必须校验精度（使用 BigDecimal，禁止 float/double），防止精度丢失
-- 支付状态必须通过主动查询支付网关确认，不能只依赖回调通知
-- 退款必须支持部分退款和全额退款，退款总额不能超过支付总额
-
-## 约束条件
-- 支付密钥必须加密存储，禁止明文配置
-- 支付回调接口必须验证签名，禁止无签名校验直接处理
-- 支付流水表独立于业务表，禁止与订单表耦合
-- 支付敏感操作必须有审计日志（操作人、时间、金额、状态变更）
-- 支付操作必须记录完整流水（请求、响应、回调），便于对账和纠纷处理
-- 支付超时时间必须与支付网关一致（如 30 分钟），超时自动关闭订单
-- 同一笔支付必须防止重复扣款（幂等性），使用支付流水号去重
-
-## 例外情况
-- 测试环境使用沙箱支付，禁止真实交易
-- 充值卡/优惠券抵扣不走第三方支付，但走相同的金额计算和审计规则
-- 银行卡支付可能延迟到账（T+1），需要异步确认最终状态
-
-## 关联模式
-- [[concurrency-control]] 并发扣款控制
-- [[transaction-pattern]] 支付事务保障
-- crud-operation
-- concurrency