market-assistant/docs/Market-Assistant-项目进展与里程碑.md

# Market-Assistant（前台事业部 AI 增强启动器）— 项目进展与里程碑

> 文档版本：2026-04-09（末次修订：**阶段 2.1～2.2 MVP** 市场策略制定已接入工作台；阶段 1.4 仍待业务侧脱敏截图/录屏）  
> 目标：市场策略、竞品分析、文档体系、营销内容一键生成；手工作业投入降低 **≥50%**（需先定义基线与度量方式）。

---

## 一、总体目标与成功标准

| 维度 | 说明 |
|------|------|
| **产品范围** | 面向前台事业部的统一入口：采集/分析 → 策略与文档 → 营销素材，尽量少切换工具。 |
| **效率目标** | 在约定场景下（如：单次品类竞品简报、周报型材料），端到端耗时与人工步骤较基线下降 **≥50%**。 |
| **质量目标** | 输出可追溯（数据来源、生成时间、模型/规则版本）；关键结论可人工复核。 |
| **工程目标** | 每个里程碑结束：**代码提交并推送到远程仓库**（见文末 Git 检查清单）。 |

---

## 二、现状盘点（已有什么）

以下基于 **Market-Assistant** 子项目当前能力整理。

| 模块 | 已有能力 | 备注 / 缺口 |
|------|-----------|-------------|
| **后端** | Web 框架 + 任务创建、详情、下载、在线预览；后台线程执行任务 | 需明确生产部署、队列/进程模型是否从 Thread 演进 |
| **配置** | 环境变量；数据根目录指向低 GI 项目数据区 | 文档化部署步骤与必填项 |
| **京东链路** | 搜索/商详/评论等采集脚本及可选 AI 辅助 | 与「策略/文档/营销」产品化能力可继续加深 |
| **前端** | 京东工作台：**搜索采集**、**任务列表**、**库内数据浏览**、**报告生成**、**报告查看**、**市场策略制定**；报告在线预览；报告统计项表单化 | 淘宝/天猫为占位页；缺少「一键 Word/PPT」与「营销内容」独立工作流 |
| **数据落盘** | 任务产物含合并表、搜索导出、评价、商详、报告等 | lean 合并表与商详导出与库表对齐；全量归档规范仍可加强 |

**京东 / 流水线数据层（2026-04-09 前后已落地）**

- **合并宽表（lean）**：搜索全列 + 固定商详子集（品牌、到手价、店铺、类目路径、参数、配料）+ 评论摘要；已去掉入库与导出不需要的 HTTP 状态类字段。  
- **商详导出（lean）**：与合并表商详子集一致；支持离线重写商详表再入库。  
- **库表迁移**：已做合并表与商详行相关迁移；对旧库尽量可安全执行。  
- **采集解析**：PC 搜索卖点等兜底；竞品报告类目读中文类目列与路径。  

**结论**：**数据采集与部分分析骨架已在**，数据层在京东单次任务链路上 **schema 与库表已收敛一层**；下一步重点是 **产品化工作流**、**模板与一键生成**、**基线度量** 与 **多平台/多场景扩展**。

**进展摘要（2026-04-09 前后已落地，竞品分析子闭环）**

| 方向 | 内容 |
|------|------|
| **任务模型** | 任务上可配置报告调参（关注词、场景组、外部市场表）；创建时可带入，成功后也可单独修改再重生成。 |
| **报告与摘要** | 按任务配置与内置默认合并后生成在线分析报告与结构化摘要；重新生成报告与拉取摘要均读当前任务配置。 |
| **前端信息架构** | 菜单拆分：**报告生成**与**报告查看**；查看页 **一键下载简报包**（ZIP）。 |
| **可用性** | 搜索采集页配置采集参数，与报告统计解耦；报告侧为中文表单 + 可选高级项；外部市场表列宽已约束。 |
| **工程** | 含报告调参相关迁移与自动化测试（关注词等烟测）。 |
| **演示与基线（文档）** | 演示走查、脱敏说明、手工基线表模板；工程说明含线程执行任务与生产演进提示。 |
| **市场策略制定（阶段 2 MVP）** | 中文策略输出模板；工作台一键生成策略框架稿 + 附录速览（可选业务备注）；文档体系轻量说明 | Word 导出、LLM 润色、完整向导式多步表单为后续项 |

---

## 三、差距与下一步（要做什么）

按目标拆成四条主线，可并行但建议优先级如下。

1. **竞品分析闭环**：从「能跑任务」到「固定输入 → 固定输出（简报/PPT 大纲/对比表）」+ 引用数据源。  
2. **市场策略**：在竞品与内部假设输入之上，结构化输出（定位、人群、渠道、节奏）并可导出 Word 等文稿。  
3. **文档体系**：目录模板、命名规范、版本记录；与仓库或对象存储对齐（可选）。  
4. **营销内容一键生成**：基于同一事实层生成多体裁（标题包、详情页卖点、短视频脚本提纲等），并支持人工编辑再导出。

**阶段 1 当前建议的「下一步」（优先序）**

1. **对齐阶段 0**：若尚未完成，补 **0.1～0.3**（标准场景、手工基线、远程仓库首次 push）。  
2. **阶段 1.4 收口（业务侧）**：按演示走查打勾并附 **2～3 张脱敏截图** 或 **短录屏**（仓库可不存大 ZIP；脱敏见同目录说明）。  
3. **阶段 2 持续推进**：模板与规则草稿已可用；可补 Word 导出、变更日志、向导增强（见下表阶段 2）。  
4. **可选增强**：简报包内 **打印友好 HTML** 或 **Word 导出**。  
5. **工程债**：线程模型已记在工程说明中；生产部署再扩写部署文档。

---

## 四、阶段规划、小任务与时间节点

> 起始参考日：**2026-04-09**。若启动日晚于该日，整体顺延；**每个阶段结束日 = 必须完成「提交 + 推送」的截止日**。

### 阶段 0：启动与基线（约 1 周）

| 序号 | 任务 | 产出 | 建议完成日 |
|------|------|------|------------|
| 0.1 | 与业务方确认 2～3 个**标准场景**（如：低 GI 品类京东竞品周报） | 场景说明文档（可放本目录或 Confluence） | **2026-04-11** |
| 0.2 | 为每个场景记录**当前手工步骤**与平均耗时 | 基线表（步骤数、分钟数、责任人） | **2026-04-14** |
| 0.3 | 远程仓库初始化：忽略规则、分支策略、最小运行说明 | 可克隆可运行说明 + **首次 push** | **2026-04-16** |

**阶段 0 里程碑 Git**：合并「基线说明 + README」等到主分支并 **push**。

---

### 阶段 1：竞品分析 MVP（约 2～3 周）

| 序号 | 任务 | 产出 | 建议完成日 |
|------|------|------|------------|
| 1.1 | 统一单次任务的**输出规范**（字段、报告结构、失败重试） | 流水线输出说明 + OpenAPI 子集 + 示例 JSON（**已落盘**；含报告调参、更新配置、默认模板等） | **2026-04-23** |
| 1.2 | 后端：从任务结果生成**结构化竞品摘要**（规则 + 可选 LLM） | 可查询的结构化摘要能力（**规则版已可用**；LLM 润色为后续项） | **2026-04-30** |
| 1.3 | 前端：竞品页一键「生成简报」+ 在线阅读/下载 | UI 联调 | **2026-05-07**（**已交付**：报告查看页「一键下载简报包」ZIP） |
| 1.4 | 联调与演示数据集（脱敏） | 演示录屏或截图 + 样例数据 | **2026-05-09**（**文档已备**；**待业务补**：脱敏截图/录屏；大样本勿提交 Git） |

**阶段 1 里程碑 Git**：打 tag 可选，如 `v0.1-competitor-mvp`，并 **push**。

---

### 阶段 2：市场策略 + 文档体系（约 2～3 周）

| 序号 | 任务 | 产出 | 建议完成日 |
|------|------|------|------------|
| 2.1 | 定义「市场策略」**输出模板**（章节、必填项、可选 AI 补全） | 中文策略模板（**已落盘**；Word 版可选后续） | **2026-05-16** |
| 2.2 | 后端：策略生成能力（输入：结构化摘要 + 业务约束） | 策略制定接口（**已落盘**，规则无 LLM） | **2026-05-23** |
| 2.3 | 文档体系：文件夹模板、命名规则、变更日志或版本页 | 文档体系轻量说明（**已落盘**）；变更日志待团队约定 | **2026-05-28** |
| 2.4 | 前端：「市场策略制定」向导式表单 + 预览导出 | 工作台任务选择 + 备注 + 预览/下载（**已落盘**）；多步向导可后续增强 | **2026-05-30** |

**阶段 2 里程碑 Git**：**push**；建议特性分支合并后主分支可演示。

---

### 阶段 3：营销内容一键生成（约 2～3 周）

| 序号 | 任务 | 产出 | 建议完成日 |
|------|------|------|------------|
| 3.1 | 定义营销**体裁清单**（标题、卖点、FAQ、短视频提纲等）与字数约束 | 提示词/规则配置 | **2026-06-06** |
| 3.2 | 后端：批量生成接口（同一事实层 → 多体裁） | API + 限流/缓存策略 | **2026-06-13** |
| 3.3 | 前端：一键生成 + 分 tab 展示 + 复制/导出 | UI | **2026-06-18** |
| 3.4 | 与阶段 0 基线对比，粗测耗时下降比例 | 内部复盘表 | **2026-06-20** |

**阶段 3 里程碑 Git**：**push**；若达到 ≥50% 目标则记录证据（前后对比表）。

---

### 阶段 4：硬化与推广（约 1～2 周）

| 序号 | 任务 | 产出 | 建议完成日 |
|------|------|------|------------|
| 4.1 | 权限、密钥、日志与审计（按公司规范） | 配置说明 | **2026-06-25** |
| 4.2 | 部署文档（Docker/主机二选一） | README 或单独部署说明 | **2026-06-27** |
| 4.3 | 前台事业部试用反馈一轮 | 问题清单 + 下一迭代 backlog | **2026-06-30** |

**阶段 4 里程碑 Git**：**push**；可选 `v1.0-internal-release`。

---

## 五、每个节点：提交与推送仓库（必做）

建议在每次「任务行」完成或「阶段结束日」执行：

1. 确认工作区仅包含预期变更。  
2. 提交并写清说明（团队统一前缀更好）。  
3. 推送到远程约定分支。  
4. 若使用 PR：合并后再 **push** 更新后的主分支。  
5. 重要里程碑可在远程打 **tag** 便于回溯。

**原则**：不以「本地只有」为完成标准；**远程仓库可见**才算里程碑闭合。

---

## 六、风险与依赖

| 风险 | 应对 |
|------|------|
| 爬虫稳定性 / 合规 | 明确使用范围；失败降级为「人工上传 CSV」 |
| LLM 成本与质量波动 | 规则优先 + LLM 增强；版本化 prompt；抽样质检 |
| 「50%」无基线 | 阶段 0 必须完成基线表，否则目标不可验收 |
| 多人协作冲突 | 按阶段切分支；文档与接口先行 |

---

## 七、文档维护

- 每次阶段结束后更新本文件「二、现状盘点」与「四、阶段规划」中的**实际完成日**与**偏差说明**；数据层/爬虫有结构变更时在「京东 / 流水线数据层」小节补一句即可。  
- 负责人、会议纪要与更细任务可链接到内部 wiki，本文件保持**一页纸可读完**。

---

*项目进展与里程碑（Market-Assistant）*