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 变更检测错误
• 完成构建、单测和数据完整性校验
• 将前端默认数据模式切换为国内 VOC 后端 API，静态案例仅保留为显式回退
• 从 Parse 快照读取 2,817 个自有商品和 37 个竞品商品，并展示真实竞品标题、型号及入库状态
• 拉取 37 个竞品的首批真实评论并幂等保存 355 条脱敏评论证据
• 复用原详情框架与共享组件，增加竞品实图、档案、关联本品、评分分布、评论趋势和评论明细页

周六前 P0

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

P0 验收标准

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

后续 P1

• 升级到受支持的 Angular 版本并完成全量回归
• 处理生产依赖剩余的 13 项公告（0 critical、10 high、3 moderate），包括 Angular/ECharts 大版本升级及 xlsx 替换
• 按实际国内功能边界裁剪未挂路由的跨境模块
• 将 asin 兼容字段逐步替换为 productId
• 增加评论采集任务状态、失败重试和导入批次页面
• 为京东以外的平台增加独立字段适配器和契约测试

当前外部阻塞

• 德玛仕 Excel 不包含评论正文；当前 355 条评论均来自 37 个映射竞品的首批中转采样，自有商品评论仍为 0。
• 当前价格接口 TLS 连接失败，尚未形成价格或销量历史快照。
• 独立 PostgreSQL / Parse 的连接信息尚未提供或创建。

竞品变化驱动 Listing 闭环（2026-08-31）

• 新增竞品 Listing 历史详情 API 与响应式前端页面（快照、字段级 diff、采集失败记录、字段筛选）。
• 增加变化预警列表（价格/在售/标题/主图/规格/多竞品同向）。
• 增加影响分析、优化任务工作台与评分证据展示。
• 接入评分验证持久化和前后评分录入交互。

Cloud Function migration (2026-09-03)

当前状态：暂缓线上托管验收，回归本地前端 + 本地后端代理真实 Parse REST 数据开发。 禁止使用静态案例数据；云函数源码、Function 配置和迁移结果保留，待线上 Parse _User 与工作区成员准备完成后再恢复。

• Add the single CloudApiService browser boundary and remove direct business REST, Parse Query, and component fetch calls.
• Add the allow-listed action registry and local /api/functions adapter.
• Add and deploy the Parse Function record at /saas-voc-gateway with authentication, workspace/RBAC, product scope, cursor reads, writes, idempotency, audit, and controlled upstream failures.
• Preserve static domesticDatasetMode: 'case' and verify the packaged dashboard and 37-item competitor case view.
• Switch the default browser runtime to authenticated live Parse data; case mode remains explicit-only.
• Enforce live Parse/API mode for browser pages; static case fixtures are no longer selectable at runtime.
• Remove case branding from the production page shell; live Parse is the only browser runtime data source.
• Verify frontend 117/117 tests, server 142/142 tests, type checks, production build, data validation, and Function source security tests.
• Run authenticated production page and network-panel acceptance with a dedicated test Session.
• Complete live Amazon/Sorftime/TikHub provider contracts and background worker execution in the managed Function environment.