4.2 KiB
Market-Assistant（低 GI / 京东采集与竞品分析）
本目录可作为独立 Git 仓库根目录：克隆后只需配置 .env 与数据区，即可部署并实现当前工作台全部能力（任务、入库、浏览、报告、策略、LLM 等）。代码不依赖仓库外的 crawler/ 等目录；爬虫副本在 backend/crawler_copy/jd_pc_search。
面向「前台事业部」的 Web 工作台：提交京东关键词采集任务、查看流水线产出、库内分页浏览已入库的搜索/商详/评价数据、生成竞品分析报告，并支持导出 JSON / CSV / Excel。
跑批 CSV、pipeline_runs 等默认写在本仓库根目录下的 data/JD/；若数据需放在其它磁盘，可在 .env 中设置 LOW_GI_PROJECT_ROOT 为绝对路径。
环境变量：全栈只使用一份 market_assistant/.env（模板为 .env.example），勿在仓库根或其它子目录再建第二份 .env。
研发对接：任务产物、状态与 REST 能力见项目内 流水线输出说明 与 OpenAPI 子集；部署与 Git 整理见 docs/DEPLOY_AND_GIT.md。
技术栈
| 部分 | 说明 |
|---|---|
| 后端 | Django 5 + Django REST Framework，SQLite（可配置路径） |
| 前端 | Vue 3 + Vite 5 + Vue Router，开发时通过 Vite 代理访问 API |
| 采集 | 京东 PC 搜索侧脚本副本（与流水线任务联动） |
环境准备
- Python 3.11+（建议虚拟环境）
- Node.js 18+（用于前端）
- 唯一环境文件：在本目录（
market_assistant/）执行：
copy .env.example .env
编辑 .env，至少设置：
- DJANGO_SECRET_KEY；生产环境将 DJANGO_DEBUG 设为 False，并配置 ALLOWED_HOSTS 与 CORS/CSRF。
- LOW_GI_PROJECT_ROOT（可选）：不填则数据写在仓库根下
data/JD/；单独数据盘时再填绝对路径。 - 若使用配料识别、报告/策略 LLM：在同一文件填写 OPENAI_* 或 LLM_*（与
AI_crawler共用，无需另建.env）。
启动后端
在后端子目录下执行：
cd market_assistant/backend
# 安装依赖（建议在 venv 中）
pip install -r requirements.txt
# 数据库迁移
python manage.py migrate
# 开发服务（默认 http://127.0.0.1:8000）
python manage.py runserver
管理后台（可选）：创建超级用户后访问 Django 管理地址。
启动前端
在前端子目录下执行：
cd market_assistant/frontend
# 首次安装依赖
npm install
# 开发模式（默认 http://127.0.0.1:5173）
npm run dev
浏览器打开本地开发地址。开发环境下，前端将 API 代理到后端端口，因此需先启动后端，再启动前端。
其他脚本：
npm run build # 生产构建
npm run preview # 本地预览构建结果
常用功能说明
- 搜索采集：创建京东关键词流水线任务（翻页、SKU 上限、Cookie 等；报告统计规则在「报告生成」）。
- 任务与结果：查看任务状态；成功任务可 库内浏览、文件预览与下载、导出。
- 报告生成：配置统计规则并重新生成分析报告文件。
- 报告查看：在线预览、单文件下载、加载结构化摘要、一键下载简报包（ZIP）。
- 结构化摘要：与报告同口径的规则化 JSON，供联调或其它工具使用。
- 市场策略制定：选成功任务，可选填业务备注，生成策略向 Markdown（目标、战场、定位选项、支柱与行动；规则版、非大模型）。
任务成功结束后会自动执行入库；也可在「库内浏览」里从批次目录重新入库。
API 前缀
开发时 REST 接口默认在后端根地址下的 /api；前端通过同源代理访问即可。
相关文档
均在项目 docs 目录下，主要包括：项目进展与里程碑、流水线输出说明、演示与脱敏、工程说明等。
部署、Git 仓库整理、单 .env 约定：见 docs/DEPLOY_AND_GIT.md。
目录结构（简要）
- backend：Django 与任务流水线 API
- frontend：Vue + Vite 工作台
- docs：说明、模板、演示与 OpenAPI 等