Saas-voc/TASKS.md

Saas VOC 任务清单

更新时间：2026-07-23

已完成

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

周六前 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 的连接信息尚未提供或创建。