AI 本地营销 · 产品研发进度文档
版本：v2.0.0 | 日期：2026-06-29 | 状态：已上线
一、产品定位
面向本地商家的 AI 自动化营销平台，核心理念：主打易用——按行业智能出 AI 营销文案模板，默认自动营销，商家只填基本信息即自动创建；高级用户才提供高级自主创作。
核心能力：行业智能模板 + 一键自动营销 + AI 生图 + 智能发券闭环 + LBS 人群/到店预测 + 数据看板归因。
二、已完成模块（v2.0.0）
| 阶段 | 模块 | 核心内容 | 状态 |
|---|---|---|---|
| A | 行业智能模板 | 13 行业 × 5 场景 = 65 种子模板，按 category_name 命中，未命中回退通用；后台可管理 | ✅ 上线 |
| A | 一键自动营销 | AutoMarketingService 一次 AI 调用生成 intro/faq/promo/活动文案/标语，落草稿+LBS活动；入驻即自动 | ✅ 上线 |
| A | 底部导航重构 | 店铺/AI营销/商品/订单/我的；AI营销 tab 枢纽页 | ✅ 上线 |
| C | 智能发券闭环 | AI 发券策略→建券→LBS 人群+到店预测圈人→自动发券(频控)→券核销归因；CronSmartCoupon | ✅ 上线 |
| B | AI 生图 | 通义万相(百炼)异步生图→存阿里云OSS；商户端一键海报 | ✅ 上线 |
| D | 高级创作 | 商户端内容/活动文案/关键词三 Tab 高级创作页 | ✅ 上线 |
| D | 深度优化 | 券带单营收归因、到店预测样本导出、utf8mb4升级、AI用量统计、发券定时自助开关 | ✅ 上线 |
三、技术架构
- 后端：ThinkPHP 6.0 / PHP 8.2 / NiuShop 架构二次开发
- AI 文本：多 Provider（DeepSeek/火山豆包/Claude），原生 curl，结构化 JSON 输出，用量/成本/预算/拒答全链路
- AI 生图：通义万相 DashScope 异步任务（提交→轮询120s→下载→存OSS），火山即梦/可灵预留
- 发券：复用 NiuShop coupon 插件（CouponType/MemberCoupon），Cron 定时调度
- 人群/预测：LbsAudienceService 行为圈人 + predictArrival 到店预测(rule_v1，预留真实模型接口)
- 三端：yp_admin(平台后台) / yp_mshop(商户端 uniapp) / yp_uniapp(消费者端 uniapp)
四、关键文件清单
- 服务层：app/service/marketing/（AutoMarketingService、SmartCouponService、AiImageService、IndustryTemplateService 等 20+ 服务）
- 数据表：18 张（shop_site/geo_content/lbs_campaign/ai_generate_task/ai_usage_log/marketing_industry_template 等）
- 商户端 API：app/shopapi/controller/Geomarketing.php（登录态，site_id 隔离）
- 商户端页面：yp_mshop/pages/geomarketing/（index.vue 枢纽页 + advanced.vue 高级创作）
- 后台管理：app/admin/controller/Geomarketing.php + view/geomarketing/*.html（11+页面）
- 详细进度存档：docs/geo-lbs-ai-marketing-progress.md
五、剩余问题与待办（按优先级）
| 问题 | 说明 | 依赖/阻塞 |
|---|---|---|
| 到店预测真实模型 | 当前 rule_v1，sampleDataset 已可导出训练样本；需积累足够历史样本后训练 LR/GBDT 替换 | 样本积累（非阻塞，接口不变） |
| 排名监控真实接入 | 豆包/文心/高德/美团/百度均无公开排名 API，当前人工录入+AI建议 | 企业资质/付费服务 |
| AI 内容 A/B 效果对比 | 需 A/B 实验框架，投入产出比低 | 暂缓 |
| 火山即梦/可灵生图接入 | 需 AK/SK 签名/JWT 鉴权，预留骨架 | 外部 Key |
| 消费者端真机联调 | yp_uniapp 站点页/附近活动页/事件上报已开发，待小程序编译真机验证 | 真机 |
| 订单归因 anonymous_id→member_id | 不侵入核销/支付回调（高风险低价值），conversion 保留为消费者端集成点 | 架构权衡 |
六、版本规划
- v2.0.x：bug 修复与小优化（不改表结构）
- v2.1.0：火山即梦/可灵生图接入 + 消费者端真机联调收敛
- v2.2.0：到店预测真实模型训练替换 + 归因闭环增强
详细变更见 docs/VERSION.md。每次发版升中段，bugfix 升末段。