# Saas VOC 任务清单

更新时间：2026-07-23

## 已完成

- [x] 初始化独立 `Saas-voc` Git 仓库
- [x] 固定原框架来源提交 `9326c20`
- [x] 将原 Angular App Shell、导航、共享组件和 VOC 页面迁入仓库根目录
- [x] 保留 Parse、`fmode-ng`、ECharts 和原 VOC 页面依赖
- [x] 建立 `platform + productId` 标准身份和 `asin` 兼容层
- [x] 实现德玛仕 Excel 规范化脚本和数据校验脚本
- [x] 接入 2,817 个真实商品、9,717 条日指标和 40 条竞品关系
- [x] 接通商品搜索、商品选择、VOC 页面商品上下文和真实零评论空状态
- [x] 迁入经营概览、商品经营详情、品类分析和竞品关系页面
- [x] 迁入 VOC 趋势总览、类目 VOC 和风险预警页面
- [x] 迁入商品 VOC 详情，复用原详情布局、样式和共享组件，并接通六个内容标签
- [x] 迁入 VOC 数据趋势、情绪分布和店铺监测细分页
- [x] 迁入退款概况、退款归因和退款特征关联三层框架
- [x] 迁入趋势、需求、竞品对标、产品定义和生命周期复盘五个新品开发环节
- [x] 迁入建议看板、体验优化、产品迭代和长期策略四个行动建议页面
- [x] 建立原框架安全启用、国内等价承接和刻意排除矩阵
- [x] 复用原 `PageHeader`、`SummaryMetricCard`、`ContentCard`、`DataTableShell`、`ProductIdentity`、`BoardTabs`、`NeuButton`、`LoadingSpinner` 和 `EmptyState`
- [x] 将左侧导航整理为“经营分析”“市场与竞品”“VOC 全局监测”“VOC 深度洞察”和“数据接入状态”五组结构
- [x] 将原 `FilterBar` 解耦为可关闭旧数据选项自动加载的外部受控模式
- [x] 将 VOC 总览、类目 VOC、风险预警和数据状态页的卡片、页签、按钮统一回原共享组件
- [x] 为数据状态、VOC 总览和类目 VOC 补齐共享加载态与错误态
- [x] 接通商品列表和经营详情到商品 VOC 详情的真实商品上下文
- [x] 增加数据接入状态页
- [x] 将 Parse 和电商中转默认地址改为同源路径
- [x] 移除旧跨境线上域名和旧 Parse 二次登录逻辑
- [x] 完成 29 个启用入口的桌面与移动端响应式验收
- [x] 修复类目 VOC 首次加载的 Angular 变更检测错误
- [x] 完成构建、单测和数据完整性校验

## 周六前 P0

- [ ] 创建全新的 PostgreSQL 数据库
- [ ] 创建独立 Parse 应用，配置独立 `appId`、server URL 和 master key
- [ ] 在服务端配置 Fmode API Key，不把 Key 下发到浏览器
- [ ] 恢复或确认 Fmode 生产 TLS 入口可用
- [ ] 用德玛仕京东商品 `11266507445` 验证商品详情接口
- [ ] 用同一商品验证评论列表接口和分页字段
- [ ] 固化公司电商数据中转响应到国内领域模型的字段映射
- [ ] 实现商品、日指标、竞品关系和评论的幂等导入
- [ ] 将前端读取切到独立 Parse 应用，并保留明确的本地案例模式
- [ ] 部署独立前后端环境并跑一次端到端验收

## P0 验收标准

- [ ] 新环境与原跨境数据库完全隔离
- [ ] 输入一个国内平台商品 ID 后能获取并保存商品与评论
- [ ] 选择商品后 VOC 页面展示真实评论统计，或显示可解释的真实空状态
- [ ] 失败请求不写入脏数据，不伪造分析结果
- [ ] 浏览器和 Git 中不存在 Fmode、供应商、Parse master key 或数据库密码
- [ ] `npm run build`、`npm test`、`npm run verify:data` 全部通过

## 后续 P1

- [ ] 升级到受支持的 Angular 版本并完成全量回归
- [ ] 处理 `npm audit` 中原框架遗留的 78 项公告；其中生产依赖 17 项（1 critical、11 high、5 moderate）
- [ ] 按实际国内功能边界裁剪未挂路由的跨境模块
- [ ] 将 `asin` 兼容字段逐步替换为 `productId`
- [ ] 增加评论采集任务状态、失败重试和导入批次页面
- [ ] 为京东以外的平台增加独立字段适配器和契约测试

## 当前外部阻塞

- Fmode 生产入口 TLS 握手在本机测试时被连接端重置，尚未完成真实公司中转字段验证。
- 德玛仕 Excel 不包含评论正文，当前评论样本数为 0。
- 独立 PostgreSQL / Parse 的连接信息尚未提供或创建。