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

## 周六前 P0

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

## P0 验收标准

- [ ] 新环境与原跨境数据库完全隔离
- [x] 输入一个国内平台商品 ID 后能获取并保存商品与评论
- [x] 选择竞品后详情页展示真实评论统计；自有商品无评论时显示可解释空状态
- [x] 失败请求不写入脏数据，不伪造分析结果
- [x] 浏览器和 Git 中不存在 Fmode、供应商、Parse master key 或数据库密码
- [x] `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）

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

## Cloud Function migration (2026-09-03)

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

- [x] Add the single `CloudApiService` browser boundary and remove direct business REST, Parse Query, and component fetch calls.
- [x] Add the allow-listed action registry and local `/api/functions` adapter.
- [x] 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.
- [x] Preserve static `domesticDatasetMode: 'case'` and verify the packaged dashboard and 37-item competitor case view.
- [x] Switch the default browser runtime to authenticated live Parse data; case mode remains explicit-only.
- [x] Enforce live Parse/API mode for browser pages; static case fixtures are no longer selectable at runtime.
- [x] Remove case branding from the production page shell; live Parse is the only browser runtime data source.
- [x] 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.