SmartOps

SmartOps 是本机生产部署的电商运营数据系统，当前重点模块包括商品数据分析、蝉妈妈热榜采集、爆款视频、达人、店铺和直播数据能力。

服务架构

本项目使用 Docker Compose 的 prod profile 在本机运行生产环境。

服务	端口	说明
nextjs	3000	前端和 Next.js API
langgraph	8000	智能分析服务
chanmama-sync	8900	蝉妈妈采集服务
mysql-readonly	3307	本地商品和蝉妈妈数据 MySQL
mysql-agent	3308	Agent 业务库
redis	6379	缓存和任务状态
milvus	19530	向量检索

本机生产启动

docker compose --profile prod up -d --build

常用访问地址：

• 前端登录页：http://127.0.0.1:3000/login
• LangGraph 文档：http://127.0.0.1:8000/docs
• 蝉妈妈健康检查：http://127.0.0.1:8900/health

蝉妈妈数据

当前蝉妈妈模块已经覆盖：

• 每日前一日热销商品榜，按 17 个业务分组采集。
• 爆款视频榜，按日期和业务分组生成快照。
• 达人画像库，按最新状态维护，不按日期做榜单。
• 店铺干净榜，按官方类目展示，业务分组仅作为采集来源追溯。
• 直播榜单和基础状态采集。

详细口径见 docs/CHANMAMA.md。

运维和发布

• 运维手册：docs/OPERATIONS.md
• 发布流程：docs/RELEASE.md
• 变更记录：CHANGELOG.md

仓库维护规则

• master 只保留已验收、可运行、可回滚的生产基线。
• 大功能使用 codex/<topic> 分支。
• 未完全验收的本地维护改动使用 codex/local-checkpoint-YYYYMMDD 分支。
• 不提交 .env、cookie、session、token、数据库 dump、采集截图和临时日志。
• 重要功能必须同时维护代码、验收结果和文档。