mirror of
https://github.com/primedigitaltech/market-assistant.git
synced 2026-07-21 23:41:39 +08:00
11 KiB
11 KiB
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） | 中文策略输出模板；工作台一键生成策略框架稿 + 附录速览（可选业务备注）；文档体系轻量说明 |
三、差距与下一步（要做什么）
按目标拆成四条主线，可并行但建议优先级如下。
- 竞品分析闭环：从「能跑任务」到「固定输入 → 固定输出（简报/PPT 大纲/对比表）」+ 引用数据源。
- 市场策略：在竞品与内部假设输入之上，结构化输出（定位、人群、渠道、节奏）并可导出 Word 等文稿。
- 文档体系：目录模板、命名规范、版本记录；与仓库或对象存储对齐（可选）。
- 营销内容一键生成：基于同一事实层生成多体裁（标题包、详情页卖点、短视频脚本提纲等），并支持人工编辑再导出。
阶段 1 当前建议的「下一步」（优先序）
- 对齐阶段 0：若尚未完成，补 0.1～0.3（标准场景、手工基线、远程仓库首次 push）。
- 阶段 1.4 收口（业务侧）：按演示走查打勾并附 2～3 张脱敏截图 或 短录屏（仓库可不存大 ZIP；脱敏见同目录说明）。
- 阶段 2 持续推进：模板与规则草稿已可用；可补 Word 导出、变更日志、向导增强（见下表阶段 2）。
- 可选增强：简报包内 打印友好 HTML 或 Word 导出。
- 工程债：线程模型已记在工程说明中；生产部署再扩写部署文档。
四、阶段规划、小任务与时间节点
起始参考日：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。
五、每个节点：提交与推送仓库（必做）
建议在每次「任务行」完成或「阶段结束日」执行：
- 确认工作区仅包含预期变更。
- 提交并写清说明（团队统一前缀更好）。
- 推送到远程约定分支。
- 若使用 PR：合并后再 push 更新后的主分支。
- 重要里程碑可在远程打 tag 便于回溯。
原则：不以「本地只有」为完成标准；远程仓库可见才算里程碑闭合。
六、风险与依赖
| 风险 | 应对 |
|---|---|
| 爬虫稳定性 / 合规 | 明确使用范围；失败降级为「人工上传 CSV」 |
| LLM 成本与质量波动 | 规则优先 + LLM 增强；版本化 prompt；抽样质检 |
| 「50%」无基线 | 阶段 0 必须完成基线表，否则目标不可验收 |
| 多人协作冲突 | 按阶段切分支；文档与接口先行 |
七、文档维护
- 每次阶段结束后更新本文件「二、现状盘点」与「四、阶段规划」中的实际完成日与偏差说明；数据层/爬虫有结构变更时在「京东 / 流水线数据层」小节补一句即可。
- 负责人、会议纪要与更细任务可链接到内部 wiki，本文件保持一页纸可读完。
项目进展与里程碑（Market-Assistant）