Saas-voc/TASKS.md

Saas VOC 任务清单

更新时间：2026-07-22

已完成

• 初始化独立 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 的真实商品上下文
• 增加数据接入状态页
• 将 Parse 和电商中转默认地址改为同源路径
• 移除旧跨境线上域名和旧 Parse 二次登录逻辑
• 完成桌面与移动端响应式验收
• 完成构建、单测和数据完整性校验

周六前 P0

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

P0 验收标准

• 新环境与原跨境数据库完全隔离
• 输入一个国内平台商品 ID 后能获取并保存商品与评论
• 选择商品后 VOC 页面展示真实评论统计，或显示可解释的真实空状态
• 失败请求不写入脏数据，不伪造分析结果
• 浏览器和 Git 中不存在 Fmode、JustOneAPI、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 握手在本机测试时被连接端重置，尚未完成真实 JustOneAPI 字段验证。
• 德玛仕 Excel 不包含评论正文，当前评论样本数为 0。
• 独立 PostgreSQL / Parse 的连接信息尚未提供或创建。