new-human/ai-marketing-automation-leadgen

AI 营销自动化获客系统

版本：业务终稿 V1

本仓库当前以“文档为主”，目标是把业务闭环、产品需求、验收口径沉淀成可直接进入研发与交付落地的统一口径。

快速阅读（建议顺序）

1. 1.先看业务定位与边界：业务需求文档（业务终稿 V1）
2. 2.再看可开发与可验收的需求拆解：PRD（V1）
3. 3.最后看三个月推进节奏与里程碑：版本规划与实施路线图（V1）

文档索引

• —核心业务与边界： 业务需求文档（业务终稿 V1）
• —产品需求与验收： PRD（V1）
• —推进节奏与里程碑： 版本规划与实施路线图（V1）
• —指标与事件口径： 事件状态与指标口径（V1）
• —技术与数据模型： 技术架构与数据模型（V1）
• —演示与验收用例： 演示脚本与验收用例（V1）
• —验证记录： 验证记录-已完成链路可跑通（2026-04-12）

术语速查

• —模板：行业模板与方案（选题/脚本/文案/账号定位/发布节奏/跟进话术/指标口径）
• —内容：可分发的素材或文案包（生成→审核→入库→排期→发布）
• —分发任务：将内容发布到指定平台/账号的可追踪任务（含重试与人工兜底）
• —线索：咨询/留资/加微/预约等结果对象的沉淀（含状态机与跟进留痕）
• —跟进记录：自动与人工触达的统一留痕（话术、结果、下一步计划）
• —指标事件：曝光/播放/互动/咨询/留资等统一口径的事件流，用于看板与复盘

本地运行

当前仓库已进入“可运行 Demo”阶段：在 apps/web 提供最小可跑通的 Web 骨架（先跑通闭环与事件口径，再逐步替换为真实 DB/API）。

启动方式：

npm --prefix apps/web install
npm run dev

默认端口：3127（如果端口冲突，设置 PORT=3137 npm run dev）

页面入口：

• —首页：http://localhost:3127/
• —工作台：http://localhost:3127/workbench（支持一键跑通 + 重置演示数据）
• —演示工作台：http://localhost:3127/demo
• —看板：http://localhost:3127/dashboard（默认按当前 trace 聚合）
• —事件：http://localhost:3127/events（可按 trace 筛选）
• —交付中心：http://localhost:3127/delivery（开通清单/培训/复盘/上线确认）
• —招商中心：http://localhost:3127/sales（价值表达/演示路径/成交留档）
• —文档入口：http://localhost:3127/docs

冒烟脚本（无需启动 Web）

npm run smoke:m1
npm run smoke:m2
npm run smoke:m3

脚本会写入 apps/web/.demo-data/state.json，然后启动 Web 后即可在事件页/看板看到该 trace 的完整事件流。