mini_tp/docs/smt_api.md

smt 戒烟小程序 ThinkPHP 模块说明

本次在 tp/app/smt 下新增了一个 ThinkPHP 多应用模块，用于承接原 wx_service 中 /api/v1/auth/* 与 /api/v1/smoke/* 的主要能力。

已迁移范围

• 小程序登录：POST /smt/v1/auth/login
• 开发登录：POST /smt/v1/auth/dev-login
• 当前用户：GET /smt/v1/auth/me
• 更新用户资料：PUT|POST /smt/v1/auth/profile
• 戒烟资料：GET|POST /smt/v1/smoke/profile
• 抽烟记录：/smt/v1/smoke/logs*
• 首页与统计：
  • GET /smt/v1/smoke/home
  • GET /smt/v1/smoke/stats
• 下次抽烟建议：
  • GET /smt/v1/smoke/ai/next_smoke_time
• AI 解锁与每日总结：
  • POST /smt/v1/smoke/ai/advice_unlocks
  • GET /smt/v1/smoke/ai/daily_summary
• 分享：
  • POST /smt/v1/smoke/share
  • GET /smt/v1/smoke/share/:token
• 戒烟计划：
  • POST /smt/v1/smoke/quit-plan/generate
  • GET /smt/v1/smoke/quit-plan
  • GET /smt/v1/smoke/quit-plan/days
  • POST /smt/v1/smoke/quit-plan/reset
• 成就：
  • GET /smt/v1/smoke/achievement/themes
  • GET /smt/v1/smoke/achievement

当前实现说明

• 数据库连接复用 dbbiz，直接对接 users、mini_programs、user_memberships、fa_smoke_*、fa_achievement_* 等表。
• 鉴权复用了原 Go 服务的语义：Authorization: Bearer <session_key>。
• AI 能力优先读取环境变量：AI_BASE_URL、AI_API_KEY、AI_MODEL、AI_TIMEOUT_SECONDS。
• 当 AI 环境变量缺失或调用失败时，已做规则版兜底，保证接口仍然可返回结果。
• 戒烟计划当前为规则生成版本，不再依赖 Go 侧的 AI 计划生成器。

未迁移范围

以下能力仍然在 Go 服务里，当前 tp/app/smt 未接入：

• /api/v2/checkin/* 戒烟打卡系统（quitcheckin）
• 梦想目标、监督人、提醒等 v2 业务
• Go 侧的 Redis session 缓存
• Go 侧更细的 AI debug log 与测试体系

如果后续要把 mini-programs/smt 完全切到 tp，下一步应继续迁移 wx_service/internal/quitcheckin 到 tp/app/smt 或单独的 tp/app/checkin。