SSA-Pro MVP 任务清单与进度追踪
文档版本： v2.0
创建日期： 2026-02-18
最后更新： 2026-02-20（Phase 2A 前端集成完成 + Block-based 架构共识）
更新频率： 每日站会后更新
当前进度： Phase 2A 完成，下一步 Phase 2B Block-based 动态渲染重构
📌 核心文档： 07-Phase2A-智能化核心开发计划.md | 08-Block-based动态结果渲染开发计划.md
状态图例
| 状态 |
含义 |
| ⬜ |
未开始 |
| 🔄 |
进行中 |
| ✅ |
已完成 |
| ⏸️ |
暂停/阻塞 |
Phase 1：骨架搭建 + 配置中台（Week 1-2）
里程碑目标： T 检验 API 端到端跑通 + 配置中台基础
R 服务任务
| 状态 |
任务 |
预估 |
备注 |
| ✅ |
创建 r-statistics-service/ 目录结构 |
2h |
含 templates/, fixtures/ 目录 |
| ✅ |
初始化 renv 并生成 renv.lock |
1h |
锁定包版本 |
| ✅ |
编写 Dockerfile（基于 rocker/r-ver:4.3） |
2h |
使用 renv::restore() |
| ✅ |
🆕 Dockerfile 配置 OSS 环境变量 |
1h |
ENV 注入，非硬编码 |
| ✅ |
安装 glue 包，创建代码模板文件 |
2h |
已在 T 检验中使用 |
| ✅ |
🆕 实现 data_loader.R（混合协议） |
3h |
支持 inline/OSS/DEV_MODE |
| ✅ |
🆕 实现 result_formatter.R（p_value_fmt） |
1h |
APA 格式化 |
| ✅ |
实现 plumber.R 入口文件 |
2h |
健康检查 + 动态路由 |
| ✅ |
🆕 plumber.R 添加 Debug 模式支持 |
1h |
DEV_MODE 环境变量 |
| ✅ |
定义错误码枚举（error_codes.R） |
1h |
业务/系统错误分离 |
| ✅ |
🆕 扩展错误码映射表（map_r_error） |
1h |
R 错误 → 用户友好提示 |
| ✅ |
🆕 代码模板头部添加依赖安装脚本 |
0.5h |
reproducible_code 中包含 |
| ✅ |
🆕 创建 tests/fixtures/ 标准测试数据 |
2h |
normal/skewed/missing |
| ✅ |
实现 T 检验 Wrapper（ST_T_TEST_IND） |
4h |
含护栏 + glue + 缺失值处理 |
| ✅ |
本地 Docker 测试通过 |
2h |
2026-02-19 端到端测试通过 |
后端任务
| 状态 |
任务 |
预估 |
备注 |
| ✅ |
创建 backend/src/modules/ssa/ 目录结构 |
1h |
按 planner/executor/config 组织 |
| ✅ |
设计并创建数据库 Schema（Prisma） |
3h |
9张表（含配置中台） |
| ✅ |
执行 prisma migrate dev |
0.5h |
已创建迁移文件 |
| 🔄 |
安装 json-repair 和 zod 依赖 |
0.5h |
LLM 输出容错 |
| ✅ |
实现 RClientService（executor/） |
3h |
超时 120s |
| ✅ |
🆕 RClientService 添加 502/504 友好处理 |
0.5h |
错误友好提示已实现 |
| ⬜ |
🆕 DataParserService 分类变量隐私保护 |
1h |
稀有值 < 5 隐藏 |
| ✅ |
实现 POST /api/v1/ssa/execute 存根 |
2h |
完整实现，含错误处理 |
| ✅ |
注册路由到 index.ts |
0.5h |
|
| ✅ |
🆕 实现 DataParserService（数据解析） |
2h |
类型推断 + 缺失值处理 |
| ✅ |
🆕 实现分析计划生成 API |
2h |
变量智能匹配 |
| ✅ |
🆕 实现代码下载 API |
1h |
动态文件名 |
🆕 配置中台任务
| 状态 |
任务 |
预估 |
备注 |
| 🔄 |
🆕 设计统计决策表 Excel 模板 |
2h |
Goal + Y + X + Design → Tool |
| ⬜ |
🆕 实现 DecisionTableLoader |
3h |
四维匹配逻辑 |
| ✅ |
🆕 设计 R 代码库数据库表 |
1h |
r_code_library 表已创建 |
| ⬜ |
🆕 实现 RCodeLibraryService |
3h |
脚本上传/版本管理 |
| 🔄 |
🆕 定义工具配置 Excel 模板（5个Sheet） |
3h |
元数据/参数映射/护栏/输出/解读 |
| ⬜ |
🆕 实现 ParamMappingService |
2h |
JSON Key → R 参数名 |
| ⬜ |
🆕 实现 GuardrailConfigService |
3h |
Block/Warn/Switch 三种 Action |
| ⬜ |
🆕 实现 InterpretationService |
2h |
解读模板填空 |
| ⬜ |
🆕 实现 ConfigValidatorService |
2h |
必填/格式/唯一性校验 |
| ✅ |
🆕 实现配置热加载 API |
1h |
POST /config/reload 路由已创建 |
| ⬜ |
🆕 上传 T 检验 R 脚本 + 配置 |
2h |
跑通完整流程 |
前端任务
| 状态 |
任务 |
预估 |
备注 |
| ✅ |
创建 frontend-v2/src/modules/ssa/ 目录结构 |
1h |
含 components/hooks/stores/types |
| ✅ |
注册到 moduleRegistry.ts |
0.5h |
已激活模块 |
| ✅ |
实现基础页面框架（SSAWorkspace） |
3h |
参考原型图 |
| ✅ |
🆕 实现模式切换 Tab（智能分析/统计咨询） |
2h |
双模式入口 |
| ✅ |
实现左侧边栏组件 |
2h |
含数据信息展示 |
| ✅ |
实现数据上传组件（DataUploader） |
3h |
Drag & Drop |
| ✅ |
🆕 实现结果展示组件（ResultCard + APATable） |
3h |
三线表 + 图表 |
| ✅ |
🆕 实现执行进度组件（ExecutionTrace） |
2h |
步骤状态展示 |
| ✅ |
🆕 实现代码下载功能 |
1h |
从后端获取文件名 |
| ✅ |
🆕 实现 Zustand Store |
2h |
会话状态管理 |
| ✅ |
🆕 实现 useAnalysis Hook |
2h |
上传/计划/执行/下载 |
🆕 V11 UI 升级任务（2026-02-20 完成）
| 状态 |
任务 |
预估 |
备注 |
| ✅ |
V11 UI 像素级还原（Gemini 风格） |
8h |
全屏沉浸式体验 |
| ✅ |
SSASidebar 可收起抽屉栏 |
2h |
汉堡菜单 + 历史 |
| ✅ |
SSAChatPane 中央对话区 |
3h |
打字机效果 |
| ✅ |
SSAWorkspacePane 单页滚动布局 |
4h |
SAP→执行→结果 |
| ✅ |
多任务支持（AnalysisRecord） |
3h |
单会话多分析 |
| ✅ |
Word 报告导出（docx 库） |
2h |
完整统计报告 |
| ✅ |
输入框遮挡修复（Scroll Spacer） |
1h |
Flexbox 兼容 |
| ✅ |
代码清理（删除旧组件） |
1h |
删除 7 个废弃组件 |
| ✅ |
前后端联调测试 |
2h |
端到端验证 |
Phase 2：智能规划与咨询模式（Week 3-4）
里程碑目标： 多工具流程规划 + 数据质量核查 + 咨询模式上线
🆕 核心智能化任务（优先级最高）
| 状态 |
任务 |
预估 |
备注 |
| ✅ |
🆕 Prompt 体系整合到后端开发指南 |
2h |
动态注入模式 |
| ✅ |
🆕 多工具流程规划设计 |
3h |
WorkflowPlannerService 设计 |
| ✅ |
🆕 数据质量核查报告设计 |
3h |
DataQualityService 设计 |
| ✅ |
🆕 实现 WorkflowPlannerService |
4h |
意图识别 + 变量类型判断 + 工具智能选择 |
| ✅ |
🆕 实现 WorkflowExecutorService |
4h |
串联执行 + SSE 实时进度 + 结果完整传递 |
| ✅ |
🆕 实现 DataQualityService（Python） |
3h |
CSV 直传 Python 解析，双端点支持 |
| ⬜ |
🆕 实现 ST_QUALITY_REPORT R 脚本 |
4h |
缺失值/异常值/分布/平衡性 |
| ✅ |
🆕 实现前端数据质量核查报告卡片 |
3h |
DataProfileCard 组件 |
| ✅ |
🆕 实现前端多步骤流程展示 |
3h |
SSE 实时更新 + MVP 风格复用 |
🆕 Phase 2A 前端集成任务（2026-02-20 完成）
| 状态 |
任务 |
预估 |
备注 |
| ✅ |
🆕 SSAChatPane 工作流调用集成 |
2h |
handleSend → generateWorkflowPlan |
| ✅ |
🆕 SSE 消息格式前后端对齐 |
2h |
camelCase/snake_case 兼容 |
| ✅ |
🆕 多步骤执行日志 UI |
2h |
MVP terminal-box + TraceLogItem 复用 |
| ✅ |
🆕 多步骤结果展示 UI |
3h |
统计量/分组表/回归系数/图表 |
| ✅ |
🆕 DescriptiveResultView 组件 |
3h |
处理 variables+by_group 嵌套结构 |
| ✅ |
🆕 多步骤 R 代码聚合导出 |
1h |
SSACodeModal 工作流模式 |
| ✅ |
🆕 多步骤 Word 报告导出 |
3h |
exportWorkflowReport + 描述性统计 |
| ✅ |
🆕 CSS 布局修复 |
2h |
position/padding/max-width 系统性修复 |
| ✅ |
🆕 6 个前端 Bug 修复 |
3h |
SAP 误显示/SSE 卡死/结果丢失等 |
🆕 Phase 2B Block-based 动态渲染任务（待开始）
| 状态 |
任务 |
预估 |
备注 |
| ⬜ |
🆕 创建 DynamicReport.tsx 组件 |
2h |
4 个 Block 渲染子组件 |
| ⬜ |
🆕 创建 exportBlocksToWord.ts |
2h |
Block 数组 → Word 文档 |
| ⬜ |
🆕 后端透传 report_blocks |
0.5h |
WorkflowExecutorService |
| ⬜ |
🆕 R 辅助函数库 block_helpers.R |
1h |
make_table_block() 等 |
| ⬜ |
🆕 SSAWorkspacePane 集成 |
1h |
优先读 report_blocks，fallback 旧逻辑 |
| ⬜ |
🆕 descriptive.R 改造 |
1.5h |
输出 report_blocks |
| ⬜ |
🆕 t_test_ind.R 改造 |
1h |
输出 report_blocks |
| ⬜ |
🆕 logistic_binary.R 改造 |
1.5h |
输出 report_blocks |
| ⬜ |
🆕 chi_square.R 改造 |
1h |
输出 report_blocks |
| ⬜ |
🆕 correlation.R 改造 |
1h |
输出 report_blocks |
| ⬜ |
🆕 t_test_paired.R 改造 |
1h |
输出 report_blocks |
| ⬜ |
🆕 mann_whitney.R 改造 |
1h |
输出 report_blocks |
| ⬜ |
🆕 清理旧自定义渲染代码 |
2h |
删除 isDescriptive 等分支 |
| ⬜ |
🆕 清理旧导出逻辑 |
1.5h |
删除 classifyExportVar 等 |
R 服务任务
| 状态 |
任务 |
预估 |
备注 |
| ⬜ |
实现配对 T 检验（ST_T_TEST_PAIRED） |
3h |
|
| ⬜ |
实现单因素 ANOVA（ST_ANOVA_ONE） |
3h |
|
| ⬜ |
实现卡方检验（ST_CHI_SQUARE） |
3h |
|
| ⬜ |
实现相关性分析（ST_CORRELATION） |
3h |
|
| ⬜ |
🆕 所有 R 脚本统一 run_analysis() 入口 |
2h |
专家规范 |
| ⬜ |
实现通用护栏函数（utils/guardrails.R） |
2h |
|
| ⬜ |
🆕 护栏支持 Block/Warn/Switch Action |
2h |
三种响应策略 |
| ⬜ |
🆕 为 5 个工具上传 R 脚本 + Excel 配置 |
3h |
专家完整配置 |
后端任务
| 状态 |
任务 |
预估 |
备注 |
| ⬜ |
🆕 实现 DecisionTableService（planner/） |
4h |
四维匹配选工具 |
| ⬜ |
实现 ToolRetrievalService（planner/） |
3h |
复用 VectorSearchService（辅助） |
| ⬜ |
🆕 决策表 + RAG 融合策略 |
2h |
决策表优先，RAG 兜底 |
| ⬜ |
注册 Prompt 到 capability_schema |
2h |
4 个 Prompt |
| ⬜ |
实现 PlannerService（planner/，有数据） |
4h |
含 json-repair + Zod 校验 |
| ⬜ |
🆕 PlannerService 调用决策表匹配 |
2h |
Goal → Tool 精准匹配 |
| ⬜ |
🆕 实现 ConsultService（planner/，无数据） |
4h |
基于决策表推理生成 SAP |
| ⬜ |
🆕 实现 SAPGeneratorService（SAP 文档生成） |
3h |
Markdown → Word 导出 |
| ⬜ |
🆕 实现结果解读（InterpretationService） |
3h |
基于配置模板生成论文级结论 |
| ⬜ |
实现 POST /api/v1/ssa/sessions/:id/plan |
3h |
|
| ⬜ |
🆕 实现 POST /api/v1/ssa/consult/:id/chat |
2h |
咨询对话 |
| ⬜ |
🆕 实现 POST /api/v1/ssa/consult/:id/generate-sap |
2h |
生成 SAP |
| ⬜ |
实现会话管理 API（CRUD） |
3h |
|
| ⬜ |
实现 Brain-Hand 数据隔离逻辑 |
2h |
Schema 给 LLM，Data 给 R |
| ⬜ |
DataParserService 增加小样本隐私保护 |
1h |
N<10 时模糊化 Min/Max |
前端任务
| 状态 |
任务 |
预估 |
备注 |
| ⬜ |
实现 Chat 消息流组件 |
4h |
复用 AIStreamChat |
| ⬜ |
实现计划确认卡片（PlanCard） |
4h |
参考原型图 |
| ⬜ |
🆕 PlanCard 增加"仅下载方案"按钮 |
1h |
咨询模式 |
| ⬜ |
实现执行路径树（ExecutionTrace） |
3h |
动画效果 |
| ⬜ |
🆕 实现咨询模式 UI（ConsultChat） |
3h |
无数据对话 |
| ⬜ |
🆕 实现 SAP 预览/下载组件 |
2h |
Word/MD 下载 |
| ⬜ |
实现 API 对接（api.ts） |
2h |
|
| ⬜ |
实现 Zustand Store |
2h |
含 mode 切换状态 |
Phase 3：完善与联调（Week 5-6）
里程碑目标： MVP 功能完整，可演示
R 服务任务
| 状态 |
任务 |
预估 |
备注 |
| ⬜ |
实现 Fisher 精确检验（ST_FISHER） |
2h |
|
| ⬜ |
实现 Wilcoxon 检验（ST_WILCOXON） |
2h |
|
| ⬜ |
实现 Mann-Whitney U（ST_MANN_WHITNEY） |
2h |
|
| ⬜ |
实现简单线性回归（ST_LINEAR_REG） |
3h |
|
| ⬜ |
实现描述性统计（ST_DESCRIPTIVE） |
2h |
|
| ⬜ |
完善代码生成器（所有工具） |
3h |
|
| ⬜ |
补充错误处理（tryCatch） |
2h |
|
后端任务
| 状态 |
任务 |
预估 |
备注 |
| ⬜ |
实现 CriticService（结果解读） |
3h |
流式输出 |
| ⬜ |
实现代码下载 API |
2h |
|
| ⬜ |
导入剩余 5 个工具元数据 |
1h |
|
| ⬜ |
实现执行日志记录（execution_logs） |
2h |
|
| ⬜ |
端到端集成测试 |
4h |
|
前端任务
| 状态 |
任务 |
预估 |
备注 |
| ⬜ |
实现结果展示卡片（ResultCard） |
4h |
三线表 + 图表 |
| ⬜ |
实现代码下载功能 |
2h |
|
| ⬜ |
实现消息历史加载 |
2h |
|
| ⬜ |
UI 样式精调（对齐原型图） |
3h |
|
| ⬜ |
端到端联调测试 |
4h |
|
部署任务
| 状态 |
任务 |
预估 |
备注 |
| ⬜ |
R 服务 Docker 镜像推送 ACR |
1h |
|
| ⬜ |
SAE 创建 R 服务应用 |
2h |
|
| ⬜ |
🆕 配置 SAE 固定 2 实例 |
1h |
避免冷启动 30s+ 延迟 |
| ⬜ |
🆕 配置 R 服务 Liveness Probe |
0.5h |
检测僵尸进程，自动重启 |
| ⬜ |
🆕 配置 Node.js 内存上限 2GB+ |
0.5h |
xlsx 全量读取防 OOM |
| ⬜ |
🆕 配置 OSS Endpoint 环境变量 |
0.5h |
开发公网/生产内网 |
| ⬜ |
配置 R 服务出站策略 |
0.5h |
Deny Public, Allow VPC |
| ⬜ |
配置内网通信（Node.js → R） |
1h |
|
| ⬜ |
创建临时文件清理 CronJob |
1h |
每日清理 /tmp |
| ⬜ |
生产环境验证 |
2h |
|
进度统计
| Phase |
任务总数 |
已完成 |
进度 |
| Phase 1 |
49 |
47 |
96% |
| Phase 2 核心智能化 |
9 |
8 |
89% |
| Phase 2A 前端集成 |
9 |
9 |
100% |
| Phase 2B Block-based |
14 |
0 |
0% |
| Phase 2 其他（R/后端/前端） |
30 |
0 |
0% |
| Phase 3 |
22 |
0 |
0% |
| 总计 |
133 |
64 |
48% |
v2.0 更新：Phase 2A 前端集成完成 + Block-based 架构共识达成（2026-02-20）
v1.8 更新：纳入 Prompt 体系 + 多工具流程规划 + 数据质量核查报告设计（2026-02-20）
v1.7 更新：V11 UI 前后端联调通过，Phase 1 核心完成 96%（2026-02-20）
v1.6 更新：Phase 1 核心流程完成，T 检验端到端测试通过（2026-02-19）
风险与阻塞项
每日站会记录
2026-02-20
上午 - V11 UI 联调：
- ✅ V11 UI 像素级还原：Gemini 风格全屏沉浸式体验
- ✅ 多任务支持：单会话可执行多个分析任务，独立管理状态
- ✅ 单页滚动布局：分析计划 → 执行日志 → 分析结果，步骤进度条导航
- ✅ Word 报告导出：使用 docx 库生成完整统计报告
- ✅ 输入框遮挡修复：Scroll Spacer 方案
- ✅ 代码清理：删除 7 个旧版 V8/V9 组件
下午 - Phase 2A 前端集成（核心）：
- ✅ Python 数据质量服务集成：CSV 直传 Python 解析，修复端口/环境变量
- ✅ WorkflowPlannerService 实现：正则变量提取 + 变量类型判断 + 智能工具选择
- ✅ WorkflowExecutorService 修复：result 字段完整传递（plots/code/trace_log）
- ✅ SSE 前后端对齐：stream 路由触发执行 + 消息格式兼容
- ✅ 多步骤 UI 复用 MVP 设计：terminal-box 日志 + 统计量/表格/图表结果
- ✅ DescriptiveResultView 组件：variables+by_group 嵌套结构解析
- ✅ 多步骤导出功能：R 代码聚合 + Word 报告（含描述性统计）
- ✅ 6 个 Bug 修复：SAP 误显示、布局混乱、SSE 卡死、结果丢失、描述性统计、Word 导出
- ✅ Block-based 架构共识：评估并认可动态结果渲染协议规范
- ✅ Block-based 开发计划：
08-Block-based动态结果渲染开发计划.md
关键技术方案：
- Block-based Protocol：4 种 Block 类型（markdown/table/image/key_value）
- 渐进式迁移：report_blocks 优先，fallback 旧逻辑
- SSE 触发模式：客户端连接时异步触发 executeWorkflow
下一步：
- Phase 2B：Block-based 动态渲染重构（~2.5 天）
2026-02-19
完成项：
- ✅ R 服务 T 检验端到端测试通过
- ✅ 修复缺失值导致分组变量识别为 3 组的问题（R 服务自动过滤 NA）
- ✅ 修复 DataParserService 类型推断（0/1 数字列识别为分类变量）
- ✅ 修复后端 R 服务错误响应处理（返回 422 + user_hint）
- ✅ 修复前端代码下载文件名（从 Content-Disposition 提取）
- ✅ 修复前端用户会话隔离（组件挂载时重置 store）
- ✅ 完成前端模块注册，激活智能统计分析入口
待解决：
- 配置中台功能待开发
- json-repair 和 zod 依赖待安装
- DataParserService 隐私保护待实现
下一步：
- 进入 Phase 2 或完善 Phase 1 配置中台
HaHafeng
428a22adf2