source-kb 0.2.2__py3-none-any.whl

presets/java-spring/templates/subagent-async-events.md

@@ -0,0 +1,107 @@
+# 任务：生成 {module_name} 模块的 async-and-events.md
+
+{module_description}
+
+{execution_guidance}
+
+## 你必须遵守的规则（违反任何一条即为失败）
+
+1. **禁止编造** — 线程池参数、事件类名、异步方法签名必须从源码验证
+2. **数值验证铁律** — 核心线程数、最大线程数、队列容量、超时时间 → 必须 Read 源码确认
+3. **事件发布/订阅关系必须完整** — 谁发布、谁订阅、事件体结构、执行时机
+4. **异步失败处理必须明确** — @Async 方法异常后的行为：吞掉/日志/回调/补偿
+
+## 输出约束
+
+- 信息密度优先，避免冗余
+- 确保中文内容完整无截断
+
+## 输入
+
+- 骨架 JSON：`{skeleton_path}`（{skeleton_size}KB，{skeleton_read_instruction}）
+- 源码缓存：`{source_cache_path}`
+- 输出文件：`{output_path}/async-and-events.md`
+
+## 需要读取的源码文件
+
+根据以下文件清单读取源码文件进行分析：
+
+{file_list}
+
+## 文件读取说明
+
+你需要：
+1. 逐个读取上述文件清单中的源码文件
+2. 分析文件内容，提取所需信息
+3. 基于原始源码生成文档，禁止编造
+4. 验证所有配置参数和数值
+
+## 内容组织
+
+### 1. 异步方法总览
+
+```markdown
+| 序号 | 方法 | 所在类 | 线程池 | 返回类型 | 失败处理 |
+|------|------|--------|--------|---------|---------|
+| 1 | sendNotification | NotifyService | taskExecutor | void | 日志记录 |
+```
+
+### 2. 线程池配置
+
+每个线程池必须包含：
+- **Bean 名称**：@Qualifier 或方法名
+- **核心线程数**：具体值 + 来源（硬编码/配置项）
+- **最大线程数**：具体值
+- **队列类型与容量**：LinkedBlockingQueue(1000) / SynchronousQueue 等
+- **拒绝策略**：CallerRunsPolicy / AbortPolicy / 自定义
+- **线程名前缀**：用于日志追踪
+- **关闭策略**：waitForTasksToCompleteOnShutdown / awaitTerminationSeconds
+
+### 3. 异步方法详解（复杂方法独立小节）
+
+每个异步方法必须包含：
+- **方法签名**：完整签名含参数
+- **使用的线程池**：@Async("poolName")
+- **调用方**：哪些类/方法触发此异步调用
+- **执行逻辑**：编号步骤
+- **异常处理**：AsyncUncaughtExceptionHandler / try-catch / 补偿机制
+- **注意事项**：同类调用失效、事务边界、上下文传递
+
+### 4. Spring 事件机制
+
+#### 4.1 事件定义
+
+```markdown
+| 事件类 | 继承自 | 携带数据 | 发布时机 |
+|--------|--------|---------|---------|
+```
+
+#### 4.2 事件发布点
+
+每个发布点说明：
+- 发布位置（类.方法）
+- 发布时机（事务提交前/后、业务逻辑中）
+- 事件构造方式
+
+#### 4.3 事件监听器
+
+每个监听器必须包含：
+- **监听事件**：@EventListener / @TransactionalEventListener
+- **执行阶段**（@TransactionalEventListener）：AFTER_COMMIT / BEFORE_COMMIT / AFTER_ROLLBACK
+- **执行逻辑**：编号步骤
+- **是否异步**：@Async 组合使用
+- **失败处理**：异常后是否影响主流程
+
+### 5. 上下文传递
+
+- SecurityContext 跨线程传递方式
+- MDC 日志上下文传递
+- 自定义 ThreadLocal 传递（TaskDecorator）
+
+## 完成后自检清单
+
+- [ ] 每个线程池有完整参数（核心/最大/队列/拒绝策略）
+- [ ] 事件发布/订阅关系已完整映射
+- [ ] @TransactionalEventListener 的执行阶段已标注
+- [ ] 异步方法的异常处理已说明
+- [ ] 数值从源码验证

presets/java-spring/templates/subagent-audit-api-contracts.md

@@ -0,0 +1,40 @@
+# 任务：审计 {module_name} 模块的 api-contracts.md
+
+你是一个知识库质量审计员。对比 api-contracts.md 文档内容与源码骨架，找出不一致之处。
+
+## 审计维度
+
+1. **interface_completeness** — 所有接口是否列出
+2. **url_path** — URL 路径是否准确
+3. **http_method** — HTTP 方法是否正确
+4. **request_params** — 请求参数是否与源码一致
+5. **response_type** — 响应类型是否准确
+6. **error_codes** — 错误码是否列出
+
+## 输入
+
+- 文档内容: `{doc_content_path}`
+- 骨架数据: `{skeleton_path}`
+- 模块名: {module_name}
+
+## 输出格式
+
+输出 JSON 数组，每个元素：
+
+```json
+{
+  "dimension": "维度名称",
+  "status": "pass" 或 "fail",
+  "detail": "问题描述（fail 时必填）",
+  "fix": "修复内容（可选）"
+}
+```
+
+## 审计规则
+
+- 对比骨架中 @RestController/@Controller 类的方法与文档中的接口章节
+- 检查 @GetMapping/@PostMapping 等注解的 URL 是否与文档一致
+- 检查方法参数（@RequestParam/@RequestBody/@PathVariable）是否在文档中描述
+- 检查 @FeignClient 接口是否列出
+
+只输出 JSON，不要其他文字。

presets/java-spring/templates/subagent-audit-architecture.md

@@ -0,0 +1,38 @@
+# 任务：审计 {module_name} 模块的 architecture.md
+
+你是一个知识库质量审计员。对比 architecture.md 文档内容与源码/配置，找出不一致之处。
+
+## 审计维度
+
+1. **tech_stack_versions** — 框架版本是否与 pom.xml 一致
+2. **middleware_config** — 中间件配置是否有具体 key/topic/index
+3. **layer_structure** — 分层架构描述是否准确
+4. **config_items** — 关键配置项是否列出
+
+## 输入
+
+- 文档内容: `{doc_content_path}`
+- 骨架数据: `{skeleton_path}`
+- 模块名: {module_name}
+
+## 输出格式
+
+输出 JSON 数组，每个元素：
+
+```json
+{
+  "dimension": "维度名称",
+  "status": "pass" 或 "fail",
+  "detail": "问题描述（fail 时必填）",
+  "fix": "修复内容（可选）"
+}
+```
+
+## 审计规则
+
+- 检查文档中列出的 Spring Boot / 框架版本是否与 pom.xml 中的 parent version 一致
+- 检查中间件（Redis/Kafka/ES）是否有具体的连接配置或 key 前缀
+- 检查分层描述（controller → service → dao）是否与实际包结构一致
+- 检查 application.yml 中的关键配置项是否在文档中提及
+
+只输出 JSON，不要其他文字。

presets/java-spring/templates/subagent-audit-business.md

@@ -0,0 +1,40 @@
+# 任务：审计 {module_name} 模块的 business-logic.md
+
+你是一个知识库质量审计员。对比 business-logic.md 文档内容与源码骨架，找出不一致之处。
+
+## 审计维度
+
+1. **method_purpose** — 方法用途描述是否准确
+2. **core_logic_flow** — 核心逻辑流程是否完整
+3. **branch_conditions** — 分支条件是否完整描述
+4. **exception_handling** — 异常处理是否标注
+5. **reference_integrity** — 跨文档引用链接是否有效
+6. **dedup_compliance** — 是否有与其他文档重复的内容
+
+## 输入
+
+- 文档内容: `{doc_content_path}`
+- 骨架数据: `{skeleton_path}`
+- 模块名: {module_name}
+
+## 输出格式
+
+输出 JSON 数组，每个元素：
+
+```json
+{
+  "dimension": "维度名称",
+  "status": "pass" 或 "fail",
+  "detail": "问题描述（fail 时必填）",
+  "fix": "修复内容（可选，如果能给出具体修复文本则提供）"
+}
+```
+
+## 审计规则
+
+- 对比骨架中的 Service 类方法与文档中的 `##` 章节
+- 检查 high complexity 方法是否有完整的流程描述
+- 检查跨文档引用链接 `[text](./other.md)` 是否指向存在的文件
+- 检查是否有大段内容与 data-models.md / api-contracts.md 重复
+
+只输出 JSON，不要其他文字。

presets/java-spring/templates/subagent-audit-data-models.md

@@ -0,0 +1,40 @@
+# 任务：审计 {module_name} 模块的 data-models.md
+
+你是一个知识库质量审计员。对比 data-models.md 文档内容与源码骨架，找出不一致之处。
+
+## 审计维度
+
+1. **entity_completeness** — 所有实体类是否在文档中列出
+2. **field_consistency** — 字段名、类型、说明是否与源码一致
+3. **annotation_accuracy** — @TableName/@Column 等注解是否准确
+4. **dto_vo_coverage** — DTO/VO 类是否覆盖
+5. **enum_values** — 枚举值是否完整准确
+6. **inheritance** — 继承关系是否标注
+
+## 输入
+
+- 文档内容: `{doc_content_path}`
+- 骨架数据: `{skeleton_path}`
+- 模块名: {module_name}
+
+## 输出格式
+
+输出 JSON 数组，每个元素：
+
+```json
+{
+  "dimension": "维度名称",
+  "status": "pass" 或 "fail",
+  "detail": "问题描述（fail 时必填）",
+  "fix": "修复内容（可选）"
+}
+```
+
+## 审计规则
+
+- 对比骨架中标注 @Entity/@TableName/@Data 的类与文档中的 `##` 章节
+- 检查每个实体的字段表格是否与骨架 fields 一致
+- 检查 DTO/VO 类是否至少有一行提及
+- 检查枚举值列表是否与骨架中的 enum values 一致
+
+只输出 JSON，不要其他文字。

presets/java-spring/templates/subagent-business.md

@@ -0,0 +1,129 @@
+# 任务：生成 {module_name} 模块的 business-logic.md
+
+{module_description}
+
+{execution_guidance}
+
+## 你必须遵守的规则（违反任何一条即为失败）
+
+1. **禁止编造** — 所有内容必须有源码出处，无法确认时写 `⚠️ 待验证`
+2. **数值验证铁律** — 超时时间、TTL、线程池参数、锁参数、注解默认值、重试次数、批量大小 → 必须 Read 源码确认，禁止从骨架推断
+3. **引用优先，禁止重复** — 以下内容只写一句话摘要 + 引用链接，不展开：
+   - 缓存 Key/TTL → `（详见 [caching.md](./caching.md)）`
+   - 消息队列消息体/消费逻辑 → `（详见 [messaging.md](./messaging.md)）`
+   - DTO/VO/Entity 完整字段 → `（详见 [data-models.md](./data-models.md)）`
+   - 接口签名/参数/响应 → `（详见 [api-contracts.md](./api-contracts.md)）`
+   - 枚举完整值列表 → `（详见 [enums-and-constants.md](./enums-and-constants.md)）`
+4. **按业务流程组织** — `##` 标题用业务域命名（如"促销发布"），不是类名
+5. **只写有聚合价值的内容** — 单个方法内就能看懂的逻辑不需要文档化；跨多个类/方法的流程、隐式业务规则、设计决策才值得写
+6. **设计决策必须标注** — 用 💡 标注设计选择的原因（如"为什么用异步而非同步"）
+7. **风险必须标注** — 用 ⚠️ 标注（如"事务内发 MQ 的不一致风险"）
+
+## 本文档不覆盖的内容
+
+- 纯 CRUD 操作（无业务规则的增删改查）
+- 工具方法的实现细节（归 utils.md）
+- 数据模型字段定义（归 data-models.md）
+- 接口参数和响应格式（归 api-contracts.md）
+- Redis/Kafka/定时任务的配置细节（归各专项文档）
+
+## 全局上下文（自动注入，确保术语一致性）
+
+{global_metadata}
+
+{prior_docs_context}
+
+## 输出约束
+
+- 信息密度优先，避免冗余
+- 确保中文内容完整无截断
+
+## 输入
+
+- 骨架 JSON：`{skeleton_path}`（{skeleton_size}KB，{skeleton_read_instruction}）
+- 源码缓存：`{source_cache_path}`
+- 输出文件：`{output_path}/business-logic.md`
+
+## 需要读取的源码文件
+
+{file_list}
+
+## 必须读源码的方法
+
+{high_methods}
+
+## 已生成的中立文档（你必须引用而非重复）
+
+{generated_docs}
+
+## 内容组织规则
+
+### 每个 `##` 业务流程章节必须包含
+
+1. **入口信息**：入口类.方法、路由路径、触发方式（HTTP/定时/MQ）
+2. **业务价值**（1-2 句）：这个流程解决什么业务问题、服务于什么场景（从方法注释/类注释/命名推断）
+3. **核心业务规则**：编号列表，提炼隐式约束和分支条件
+4. **调用链**（调用深度 ≥ 3 层时）：ASCII 树形缩进，标注关键分支
+5. **设计决策**（如有）：为什么这样设计，有什么权衡
+
+### 方法级深度
+
+| 复杂度 | 描述深度 |
+|--------|---------|
+| low（纯 CRUD/getter/简单委托） | 不写，或调用链中一行带过 |
+| medium | 2-3 行（签名 + 目的 + 关键分支） |
+| high | 完整步骤 + 调用链 + 所有分支 + 风险标注 |
+
+### high 方法必须覆盖的维度
+
+业务目的、核心流程（编号步骤）、分支逻辑（所有 if/else/switch）、外部调用（Feign/MQ/Redis 只写调用点不展开细节）、并发控制、错误处理
+
+### 文档末尾：并发控制汇总（仅限本分片范围）
+
+{{#if is_shard}}
+> ⚠️ 分片模式：只汇总本分片涉及的并发控制机制，不要生成全局汇总表。
+
+仅列出本分片源码中出现的：
+- 分布式锁（锁名、粒度、超时）
+- 乐观锁（版本字段、重试策略）
+- CAS 操作
+{{else}}
+文档末尾增加一个 `## 并发控制汇总` 章节：
+
+| 机制 | 锁名/字段 | 粒度 | 超时 | 使用场景 |
+|------|----------|------|------|---------|
+{{/if}}
+
+### 禁止事项
+
+- 禁止生成消息队列事件汇总表（归 messaging.md）
+- 禁止生成 Feign 调用汇总表（归 external-integrations.md）
+- 禁止生成错误码汇总表（归 enums-and-constants.md）
+- 禁止生成线程资源总览表（归 architecture.md）
+- 禁止按类名逐个罗列（`## QueryController` ← 错误）
+- 禁止"需要确认"、"待补充"等占位文字
+
+### 源码锚点标注
+
+每个 `##` 章节的入口信息后，用 HTML 注释标注源码锚点，便于后续自动化关联：
+
+```markdown
+## 促销发布
+<!-- @source:PromotionPublishService.publish -->
+
+**入口**：PromotionPublishService.publish() / POST /api/v1/promotion/publish
+**业务价值**：将草稿态促销活动发布为生效态，触发缓存预热和门店同步
+...
+```
+
+锚点格式：`<!-- @source:ClassName.methodName -->`，取该流程的主入口方法。
+
+## 完成后自检清单
+
+- [ ] 每个 `##` 章节聚焦一个业务流程，有明确的入口和规则
+- [ ] 每个 `##` 章节有源码锚点注释（`<!-- @source:... -->`）
+- [ ] 每个 `##` 章节有 1-2 句业务价值描述
+- [ ] 所有 high 方法已读源码并覆盖核心维度
+- [ ] Redis/Kafka/DTO/API/枚举内容用引用链接，未展开
+- [ ] 无 Kafka/Feign/错误码/线程池的全局汇总表
+- [ ] 有设计决策标注（💡）和风险标注（⚠️）

presets/java-spring/templates/subagent-caching.md

@@ -0,0 +1,75 @@
+# 任务：生成 {module_name} 模块的 caching.md
+
+{module_description}
+
+{execution_guidance}
+
+## 你必须遵守的规则（违反任何一条即为失败）
+
+1. **禁止编造** — Key 格式、TTL、数据结构必须从源码验证
+2. **数值验证铁律** — TTL 具体值、Lua 脚本逻辑、CAS 比较条件 → 必须 Read 源码确认
+3. **每个 Key 必须完整** — Key Pattern、常量引用、拼接规则、数据类型、TTL、Value 格式、写入方式、使用场景、防穿透
+4. **脚本/原子操作必须有伪代码级逻辑** — 比较什么、成功做什么、失败返回什么，一句话概述不够
+
+## 输出约束
+
+- 信息密度优先，避免冗余
+- 确保中文内容完整无截断
+
+## 输入
+
+- 骨架 JSON：`{skeleton_path}`（{skeleton_size}KB，{skeleton_read_instruction}）
+- 源码缓存：`{source_cache_path}`
+- 输出文件：`{output_path}/caching.md`
+
+## 需要读取的源码文件
+
+根据以下文件清单读取源码文件进行分析：
+
+{file_list}
+
+## 文件读取说明
+
+你需要：
+1. 逐个读取上述文件清单中的源码文件
+2. 分析文件内容，提取所需信息
+3. 基于原始源码生成文档，禁止编造
+4. 验证所有配置参数和数值
+
+## 内容组织
+
+### 1. 总览表
+
+> 适用于 Redis、Memcached、Caffeine、Guava Cache、EhCache 等缓存方案。
+> 注意：本文档是缓存设计的唯一详细文档。architecture.md 只有概述引用。
+
+```markdown
+| 序号 | Key/Cache Name | 数据类型/结构 | 来源类 |
+|------|----------------|--------------|--------|
+| 1 | crm:point:account:base:{cid}:{cur} | String | PointAccountBiz |
+```
+
+### 2. 逐 Key/Cache 详解（每个缓存项独立小节）
+
+每个缓存项必须包含：
+
+- **Key Pattern / Cache Name**：完整拼接规则（含常量名引用和变量占位符）
+- **常量引用**：对应的常量名（如 `RedisKeyConstants.POINT_ACCOUNT_BASE_INFO`）
+- **拼接规则**：代码级表达式
+- **数据类型/结构**：String / Hash / ZSet / List / Set / Object / Map 等
+- **TTL/过期策略**：具体值 + 来源（硬编码 / 配置项名及默认值）。`—` 不是有效值，必须确认是永不过期还是遗漏
+- **Value 格式**：序列化格式（JSON / Protobuf / JDK / 自定义），含分隔符说明
+- **写入方式**：普通 SET / CAS / HMSET / ZADD / put / computeIfAbsent 等
+- **使用场景**：哪些类的哪些方法读取、哪些方法写入
+- **防穿透/击穿**（如有）：空值写入策略、判断逻辑、布隆过滤器
+
+### 3. 缓存策略说明
+
+按缓存模式分组，说明读写策略、一致性保证、穿透防护、淘汰策略。
+
+## 完成后自检清单
+
+- [ ] 每个缓存项的数据类型已标注
+- [ ] 每个缓存项的 TTL 有具体值或明确"永不过期"
+- [ ] 原子操作/Lua 脚本有伪代码级逻辑
+- [ ] Value 格式说明了序列化方式

presets/java-spring/templates/subagent-database-access.md

@@ -0,0 +1,114 @@
+# 任务：生成 {module_name} 模块的 database-access.md
+
+{module_description}
+
+{execution_guidance}
+
+## 你必须遵守的规则（违反任何一条即为失败）
+
+1. **禁止编造** — 表名、字段名、SQL 语句、分页参数必须从源码验证
+2. **数值验证铁律** — 批量大小、超时时间、连接池参数 → 必须 Read 源码确认
+3. **查询方法必须说明完整 SQL 语义** — 不能只写"查询用户"，必须说明 WHERE 条件、JOIN 关系、排序规则
+4. **事务边界必须明确** — @Transactional 的传播行为、隔离级别、回滚条件
+
+## 输出约束
+
+- 信息密度优先，避免冗余
+- 确保中文内容完整无截断
+
+## 输入
+
+- 骨架 JSON：`{skeleton_path}`（{skeleton_size}KB，{skeleton_read_instruction}）
+- 源码缓存：`{source_cache_path}`
+- 输出文件：`{output_path}/database-access.md`
+
+## 需要读取的源码文件
+
+根据以下文件清单读取源码文件进行分析：
+
+{file_list}
+
+## 文件读取说明
+
+你需要：
+1. 逐个读取上述文件清单中的源码文件
+2. 分析文件内容，提取所需信息
+3. 基于原始源码生成文档，禁止编造
+4. 验证所有配置参数和数值
+
+## 内容组织
+
+{{#if is_shard}}
+### 分片模式说明
+你负责的业务域：{shard_info}
+- 章节标题用业务域名，不用通用的"数据访问层总览"
+- 不需要生成全局总览表（由合并步骤统一生成）
+- 只描述本分片涉及的 Mapper/Repository
+{{/if}}
+
+### 1. 数据访问层总览
+
+```markdown
+| 序号 | Mapper/Repository | 对应实体 | 数据源 | 框架 | 方法数 |
+|------|-------------------|---------|--------|------|--------|
+| 1 | UserMapper | UserEntity | 主库 | MyBatis-Plus | 12 |
+```
+
+### 2. 逐 Mapper/Repository 详解（每个独立小节）
+
+每个数据访问接口必须包含：
+
+- **接口名**：完整类名
+- **继承关系**：BaseMapper<T> / JpaRepository<T, ID> / ElasticsearchRepository 等
+- **对应实体**：泛型参数中的实体类
+- **数据源**（如有多数据源）：使用的 DataSource 名称
+
+#### 自定义查询方法清单
+
+```markdown
+| 方法名 | 参数 | 返回类型 | SQL 语义 | 分页 |
+|--------|------|---------|---------|------|
+| findByStatus | status, pageParam | Page<Entity> | WHERE status=? ORDER BY create_time DESC | 是 |
+```
+
+#### 复杂查询详解（复杂 SQL 独立说明）
+
+每个复杂查询必须包含：
+- **方法签名**
+- **SQL/DSL 语义**：完整的查询逻辑（WHERE/JOIN/GROUP BY/HAVING）
+- **动态条件**（如有）：MyBatis 动态 SQL / Specification / QueryWrapper 构建逻辑
+- **索引依赖**：查询依赖的数据库索引（如能从注解或注释推断）
+- **性能注意**：全表扫描风险、N+1 问题、大结果集
+
+### 3. 分页策略
+
+- 分页实现方式：PageHelper / MyBatis-Plus Page / Spring Data Pageable
+- 默认分页大小
+- 深分页处理（如有）：游标分页 / 限制最大页数
+
+### 4. 批量操作
+
+- 批量插入方式：foreach / batch insert / saveBatch
+- 批量大小配置
+- 批量更新策略
+
+### 5. 事务管理
+
+- **事务注解使用**：@Transactional 的传播行为和隔离级别
+- **编程式事务**（如有）：TransactionTemplate 使用场景
+- **跨库事务**（如有）：分布式事务方案（Seata/本地消息表/TCC）
+- **只读事务**：@Transactional(readOnly=true) 的使用场景
+
+### 6. 多数据源（如有）
+
+- 数据源配置方式：@DS / AbstractRoutingDataSource / 自定义
+- 切换策略：注解驱动 / ThreadLocal / 请求级别
+- 主从分离规则
+
+## 完成后自检清单
+
+- [ ] 每个 Mapper/Repository 的继承关系已说明
+- [ ] 复杂查询有完整 SQL 语义描述
+- [ ] 分页策略已说明
+- [ ] 事务传播行为已标注
+- [ ] 数值从源码验证

presets/java-spring/templates/subagent-enum.md

@@ -0,0 +1,75 @@
+# 任务：生成 {module_name} 模块的 enums-and-constants.md
+
+{module_description}
+
+{execution_guidance}
+
+## 你必须遵守的规则（违反任何一条即为失败）
+
+1. **禁止编造** — 所有枚举值和常量值必须有源码出处
+2. **枚举值完整列表** — 禁止省略任何枚举值，每个枚举类的所有值都必须列出
+3. **枚举静态方法是核心** — 枚举的静态方法是业务规则载体，RAG 检索中最常被查询，禁止只列枚举值而忽略静态方法
+4. **常量值必须从源码验证** — 数值验证铁律，禁止凭经验填写
+
+## 输出约束
+
+- 信息密度优先，避免冗余
+- 确保中文内容完整无截断
+
+## 输入
+
+- 骨架 JSON：`{skeleton_path}`（{skeleton_size}KB，{skeleton_read_instruction}）
+- 源码缓存：`{source_cache_path}`
+- 输出文件：`{output_path}/enums-and-constants.md`
+
+## 需要读取的源码文件
+
+根据以下文件清单读取源码文件进行分析：
+
+{file_list}
+
+## 文件读取说明
+
+你需要：
+1. 逐个读取上述文件清单中的源码文件
+2. 分析文件内容，提取所需信息
+3. 基于原始源码生成文档，禁止编造
+4. 验证所有配置参数和数值
+
+## 内容组织
+
+### 1. 枚举定义（按重要度排序，核心枚举在前）
+
+每个枚举类必须包含：
+
+**枚举值完整字段表**：
+```markdown
+| code | name | info | 说明 |
+|------|------|------|------|
+| 1 | ORDER_ADD | 订单加积分 | 正常订单产生的积分 |
+```
+
+**public 静态方法签名和返回值说明**：
+```markdown
+- `isIncr(int operation)` → 判断是否为增加积分操作，返回 true 的 operation 值：{1, 3, 4, 9, 12, 13, 14}
+- `amountCovert()` → 金额转换逻辑说明
+```
+
+**错误码枚举**必须按前缀分组，列出所有 code + 中文消息，不省略。
+
+### 2. 常量定义
+
+每个常量类必须包含：
+- 所有 `public static final` 常量的名称、值、用途说明
+- 系统常量标注单位（秒/毫秒/分钟等）
+
+> **缓存 Key 常量**：只列常量名和值，不展开 Key 的使用场景和 TTL（归 caching.md）。
+> **错误码常量**：完整列出所有 code + 中文消息，按前缀分组。
+
+## 完成后自检清单
+
+- [ ] 每个枚举类的所有枚举值已列出（无省略）
+- [ ] 每个枚举类的静态方法已说明
+- [ ] 每个常量类的所有常量已列出
+- [ ] 常量值从源码验证
+- [ ] 错误码枚举按前缀分组