soloforge 1.0.0

package/templates/knowledge/acceptance_templates//346/216/245/345/217/243/350/256/276/350/256/241/346/250/241/347/211/210.md

@@ -0,0 +1,58 @@
+---
+name: 接口设计模版
+type: acceptance_template
+when: 接口设计, API设计, 接口文档, 接口定义
+scope: [backend, frontend]
+products: ["*"]
+---
+
+# 接口设计文档
+
+## 1. 接口总览
+| 序号 | 路径 | 方法 | 认证 | 描述 |
+|------|------|------|------|------|
+|      |      |      |      |      |
+
+## 2. 接口详情
+
+### 2.1 [接口名称]
+- **路径**: `POST /api/v1/xxx`
+- **认证**: Bearer Token / API Key
+- **幂等性**: 是/否（幂等键：xxx）
+
+**请求参数**:
+| 字段 | 类型 | 必填 | 校验规则 | 说明 |
+|------|------|------|---------|------|
+|      |      |      |         |      |
+
+**响应结构**:
+```json
+{
+  "code": 0,
+  "message": "success",
+  "data": {}
+}
+```
+
+**错误码**:
+| 错误码 | HTTP 状态码 | 触发条件 | 用户提示 |
+|--------|-----------|---------|---------|
+|        |           |         |         |
+
+## 3. 枚举值定义
+| 枚举名 | 值 | 含义 |
+|--------|------|------|
+|        |      |      |
+
+## 4. 页面交互映射
+| 页面操作 | 触发接口 | 加载状态 | 成功行为 | 失败行为 |
+|---------|---------|---------|---------|---------|
+|         |         |         |         |         |
+
+## 5. 接口规范检查
+- [ ] 是否定义了接口版本号和演进策略（如 /api/v1/）
+- [ ] 是否有幂等设计（写接口需标注幂等键或唯一约束）
+- [ ] 错误码体系是否完整（业务码 + HTTP 状态码双映射）
+- [ ] 是否有分页参数上限限制（防止恶意大翻页）
+- [ ] 是否有接口限流策略（QPS/并发上限）
+- [ ] 批量操作是否有数量上限（≤ 500 条）

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

@@ -0,0 +1,53 @@
+---
+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

@@ -0,0 +1,45 @@
+---
+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

@@ -0,0 +1,24 @@
+---
+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

@@ -0,0 +1,42 @@
+---
+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

@@ -0,0 +1,39 @@
+---
+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

@@ -0,0 +1,40 @@
+---
+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

@@ -0,0 +1,42 @@
+---
+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

@@ -0,0 +1,26 @@
+---
+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})

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

@@ -0,0 +1,47 @@
+---
+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

@@ -0,0 +1,44 @@
+---
+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

@@ -0,0 +1,35 @@
+---
+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

@@ -0,0 +1,34 @@
+---
+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

@@ -0,0 +1,37 @@
+---
+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

@@ -0,0 +1,37 @@
+---
+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

@@ -0,0 +1,36 @@
+---
+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