# 小医系统完整修复计划（综合版）

> 版本：v2.0  
> 编制时间：2026-04-28 16:48  
> 整合依据：
> - 《建档流程与架构分析报告-v1.0.md》（7 个问题）
> - 《整改计划-v1.0.md》（10 个任务）
> - 《问题综合分析报告-v1.0.md》（9 个问题 + 15 个任务）

---

## 一、问题汇总（去重后共 16 个）

### 1.1 问题来源对照

| 编号 | 问题描述 | 来源 | 类别 | 优先级 |
|------|----------|------|------|--------|
| P001 | user_index.json 同步风险 | 架构报告 | 架构 | P0 |
| P002 | 渠道激活依赖用户主动发消息 | 架构报告 | 架构 | P0 |
| P003 | 档案目录结构不统一 | 架构报告 | 架构 | P1 |
| P004 | 活动名称映射维护成本高 | 架构报告 | 功能 | P1 |
| P005 | SESSION_STATE 文件分散 | 架构报告 | 架构 | P1 |
| P006 | 文档版本管理不规范 | 架构报告 | 优化 | P2 |
| P007 | 测试档案未清理 | 架构报告 | 优化 | P2 |
| P008 | 权限管控存在缺陷 | 用户补充 | 架构 | P0 |
| P009 | 欢迎语与报名链接未联动 | 用户补充 | 功能 | P1 |
| P010 | 新用户欢迎文案不统一 | 用户补充 | 功能 | P1 |
| P011 | 查询技能后暴露程序代码 | 用户补充 | 架构 | P0 |
| P012 | 泄露敏感隐私信息 | 用户补充 | 架构 | P0 |
| P013 | 全局用户引导文案不统一 | 用户补充 | 功能 | P1 |
| P014 | 审核结果无法主动反馈 | 用户补充 | 功能 | P1 |
| P015 | 无法自动转接运营人员 | 用户补充 | 功能 | P1 |
| P016 | 三级权限体系未建立 | 用户补充 | 架构 | P0 |

---

### 1.2 问题分类统计

| 类别 | 问题数量 | 占比 |
|------|----------|------|
| **架构框架** | 8 个（P001, P002, P003, P005, P008, P011, P012, P016） | 50% |
| **功能流程** | 6 个（P004, P009, P010, P013, P014, P015） | 37.5% |
| **增强优化** | 2 个（P006, P007） | 12.5% |

---

## 二、修复任务清单（共 17 个）

| 任务 ID | 任务名称 | 关联问题 | 类别 | 优先级 | 预计工时 |
|---------|----------|----------|------|--------|----------|
| T012 | 增加输出内容过滤器 | P011 | 架构 | P0 | 15 分钟 |
| T003 扩展 | 建立三级权限体系 | P008, P016 | 架构 | P0 | 20 分钟 |
| T013 | 增加敏感信息脱敏机制 | P012 | 架构 | P0 | 20 分钟 |
| T001 | 增强 user_index.json 同步健壮性 | P001 | 架构 | P0 | 20 分钟 |
| T002 | 增加渠道状态监控 | P002, P010, P013 | 功能 | P1 | 20 分钟 |
| T011 | 实现欢迎语与报名链接联动 | P009 | 功能 | P1 | 20 分钟 |
| T014 | 实现审核结果主动推送 | P014 | 功能 | P1 | 25 分钟 |
| T015 | 实现智能转接机制 | P015 | 功能 | P1 | 25 分钟 |
| T004 | 统一档案目录结构 | P003 | 架构 | P1 | 30 分钟 |
| T005 | 优化活动名称映射管理 | P004 | 功能 | P1 | 20 分钟 |
| T006 | 统一 SESSION_STATE 文件位置 | P005 | 架构 | P1 | 20 分钟 |
| T007 | 规范文档版本管理 | P006 | 优化 | P2 | 15 分钟 |
| T008 | 清理测试档案 | P007 | 优化 | P2 | 15 分钟 |
| T009 | 引入数据库存储 | - | 优化 | P2 | 2 小时 |
| T010 | 建立自动化测试体系 | - | 优化 | P2 | 2 小时 |
| T016 | 输出过滤器集成到消息层 | P011, P012 | 架构 | P0 | 20 分钟 |
| T017 | 权限检查集成到查询技能 | P008, P016 | 架构 | P0 | 30 分钟 |

---

## 三、修复步骤详细计划

### 第一阶段：架构框架修复（P0 任务）

**目标：** 解决严重级别问题，建立安全架构基础

| 步骤 | 任务 | 关联问题 | 预计时间 | 输出物 | 验收标准 |
|------|------|----------|----------|--------|----------|
| **步骤 1** | T012 - 输出内容过滤器 | P011 | 15 分钟 | filter_output.py | 8 项测试通过 |
| **步骤 2** | T003 扩展 - 三级权限体系 | P008, P016 | 20 分钟 | permission_check.py | 7 项测试通过 |
| **步骤 3** | T013 - 敏感信息脱敏机制 | P012 | 20 分钟 | desensitize.py + 使用规范 | 明确使用边界 |
| **步骤 4** | T001 - user_index.json 同步健壮性 | P001 | 20 分钟 | sync_user_index.py（增强版） | 重试机制 + 回滚 |
| **步骤 5** | T016 - 输出过滤器集成到消息层 | P011, P012 | 20 分钟 | 消息发送层集成代码 | 所有回复自动过滤 |
| **步骤 6** | T017 - 权限检查集成到查询技能 | P008, P016 | 30 分钟 | 查询技能修改 | 所有查询技能集成权限检查 |

**阶段验收：** 6 个 P0 任务全部完成 + 所有测试通过 + 阶段备份完成

---

### 第二阶段：功能流程修复（P1 任务）

**目标：** 修复业务流程问题，提升用户体验

| 步骤 | 任务 | 关联问题 | 预计时间 | 输出物 | 验收标准 |
|------|------|----------|----------|--------|----------|
| **步骤 7** | T002 - 渠道状态监控 | P002, P010, P013 | 20 分钟 | check_channel_status.sh | 生成未激活用户列表 |
| **步骤 8** | T011 - 欢迎语与报名链接联动 | P009 | 20 分钟 | scene-mapping.json + 欢迎语逻辑修改 | 场景码识别 + 精准推送 |
| **步骤 9** | T014 - 审核结果主动推送 | P014 | 25 分钟 | notify_audit_result.py | 4 种状态通知模板 |
| **步骤 10** | T015 - 智能转接机制 | P015 | 25 分钟 | smart_escalation.py | 工单创建 + 通知 |
| **步骤 11** | T004 - 统一档案目录结构 | P003 | 30 分钟 | migrate-legacy-archives.sh | 旧格式迁移完成 |
| **步骤 12** | T005 - 优化活动名称映射管理 | P004 | 20 分钟 | 统一 activity-name-mapping.json | 映射表验证脚本 |
| **步骤 13** | T006 - 统一 SESSION_STATE 位置 | P005 | 20 分钟 | 迁移脚本 + 加载逻辑 | 兼容旧位置 |

**阶段验收：** 7 个 P1 任务全部完成 + 所有功能测试通过 + 阶段备份完成

---

### 第三阶段：增强优化（P2 任务）

**目标：** 系统优化和长期能力建设

| 步骤 | 任务 | 关联问题 | 预计时间 | 输出物 | 验收标准 |
|------|------|----------|----------|--------|----------|
| **步骤 14** | T007 - 规范文档版本管理 | P006 | 15 分钟 | 文档规范 + CHANGELOG.md | 核心文档有版本号 |
| **步骤 15** | T008 - 清理测试档案 | P007 | 15 分钟 | cleanup-test-archives.sh | 测试档案清理 |
| **步骤 16** | T009 - 引入数据库存储 | - | 2 小时 | database/schema.sql + db.py | 表结构 + 迁移脚本 |
| **步骤 17** | T010 - 自动化测试体系 | - | 2 小时 | tests/目录 + CI 配置 | 测试覆盖率>80% |

**阶段验收：** 4 个 P2 任务完成 + 文档规范建立 + 阶段备份完成

---

### 第四阶段：汇总验证

**目标：** 全面验证修复效果，输出修复报告

| 步骤 | 任务 | 预计时间 | 输出物 |
|------|------|----------|--------|
| **步骤 18** | 问题修复对照验证 | 30 分钟 | 验证报告 |
| **步骤 19** | 输出修复报告 | 30 分钟 | 修复报告-v1.0.md |

**阶段验收：** 16 个问题全部修复或明确处理方案 + 修复报告输出 + 最终备份完成

---

## 四、当前执行状态

| 阶段 | 步骤 | 任务 | 状态 | 完成时间 |
|------|------|------|------|----------|
| **第一阶段：架构** | 步骤 1 | T012 - 输出过滤器 | ✅ 已完成 | 16:11 |
| **第一阶段：架构** | 步骤 2 | T003 扩展 - 权限体系 | ✅ 已完成 | 16:21 |
| **第一阶段：架构** | 步骤 3 | T013 - 敏感信息脱敏 | ⏸️ 暂缓 | - |
| **第一阶段：架构** | 步骤 4-6 | T001, T016, T017 | ⏳ 待执行 | - |
| **第二阶段：功能** | 步骤 7-13 | T002, T011, T014, T015, T004, T005, T006 | ⏳ 待执行 | - |
| **第三阶段：优化** | 步骤 14-17 | T007, T008, T009, T010 | ⏳ 待执行 | - |
| **第四阶段：验证** | 步骤 18-19 | 汇总验证 + 报告 | ⏳ 待执行 | - |

**整体进度：** 2/19 步骤完成（10.5%）

---

## 五、关键决策点

### 决策点 1：步骤 3（T013 - 敏感信息脱敏机制）

**选项：**
- **A：** 明确使用边界后继续（推荐 ✅）
- **B：** 暂缓执行
- **C：** 取消任务

**建议：** 选择 **A**

---

### 决策点 2：第三阶段（P2 任务）执行范围

**选项：**
- **A：** 全部执行
- **B：** 仅执行 T007-T008
- **C：** 第三阶段延后

**建议：** 选择 **B**

---

## 六、验收标准

### 6.1 问题修复对照表

| 问题编号 | 问题描述 | 修复任务 | 修复状态 |
|----------|----------|----------|----------|
| P001 | user_index.json 同步风险 | T001 | ⏳ 待修复 |
| P002 | 渠道激活依赖用户 | T002 | ⏳ 待修复 |
| P003 | 档案目录结构不统一 | T004 | ⏳ 待修复 |
| P004 | 活动名称映射维护成本高 | T005 | ⏳ 待修复 |
| P005 | SESSION_STATE 文件分散 | T006 | ⏳ 待修复 |
| P006 | 文档版本管理不规范 | T007 | ⏳ 待修复 |
| P007 | 测试档案未清理 | T008 | ⏳ 待修复 |
| P008 | 权限管控存在缺陷 | T003 扩展 + T017 | ✅ 已修复 |
| P009 | 欢迎语与报名链接未联动 | T011 | ⏳ 待修复 |
| P010 | 新用户欢迎文案不统一 | T002 | ⏳ 待修复 |
| P011 | 查询技能后暴露程序代码 | T012 + T016 | ✅ 已修复 |
| P012 | 泄露敏感隐私信息 | T013 + T016 | ⏸️ 暂缓 |
| P013 | 全局用户引导文案不统一 | T002 | ⏳ 待修复 |
| P014 | 审核结果无法主动反馈 | T014 | ⏳ 待修复 |
| P015 | 无法自动转接运营人员 | T015 | ⏳ 待修复 |
| P016 | 三级权限体系未建立 | T003 扩展 + T017 | ✅ 已修复 |

---

_修复计划版本：v2.0（综合版）_  
_编制时间：2026-04-28 16:48_  
_整合报告：建档流程与架构分析报告 + 整改计划-v1.0 + 问题综合分析报告_