🍋 柠檬剧场 · 二期

边界固化 开发框架 Go + Gin 原生双端
v2.0 · 架构决策记录
📅 报告日期 2026-08-01 👥 团队 2 Go + 1 PHP (转Go) 🎯 DAU目标 50,000 🧩 集成 OpenIM · Lilishop · DeepSeek

📌 一、项目背景与一期现状

柠檬剧场 是中国广电合作的短剧App,一期已上线(UniApp + ThinkPHP + MySQL,阿里云ECS/RDS)。核心能力:短剧播放、穿山甲GroMore广告、看广告得金币、金币兑换、微信红包提现、自建+穿山甲内容。日活约4,000。

✅ 资金安全
分布式锁 + 实时扣减 + 单日20元硬顶,无超兑风险。
⚠️ 回调幂等
GroMore S2S回调 未做Nonce防重放,存在薅羊毛风险。
⚠️ 缓存缺失
无Redis缓存,4,000 DAU下MySQL勉强支撑,二期5万DAU必崩。
⚠️ 进度孤岛
播放进度存MySQL,但iOS/Android 未通过UnionID打通。

🚀 二、二期规划蓝图

🧠 三、关键认知修正

🚨 修正1:DeepSeek 折扣 ≠ 运营商折扣
DeepSeek API定价由官方/火山引擎统一定价,运营商只提供带宽。真正的降本路径:预付费资源包、Batch API(-50%)、缓存复用(-70%调用)。
🚨 修正2:OpenIM + Lilishop 同机部署风险
OpenIM最低 8核16G,Lilishop(SpringBoot+RocketMQ)需 4核8G。同机8核16G 必然 OOM。初期建议 16核32G 或拆分两台4核8G。
🚨 修正3:一期PHP作为“二期待调服务”的雪崩风险
ThinkPHP 同步阻塞,若慢查询耗时2s,Go的goroutine会大量阻塞导致连接池耗尽。必须设置 超时500ms + 熔断降级。

✅ 四、已拍板的5个关键决策

决策点选择落地含义
弹幕/评论审核 先发后审 用户秒发,异步送广电审核;违规则删除并通知。
购物车数据 存自己MySQL Go服务维护 cart_items 表,加购不锁库存,下单时调Lilishop扣减。
DeepSeek排队超时 >5秒返回兜底 Redis队列 + 5s context超时,超时返回预置话术库,不计费。
重构优先级 先重构金币余额 二期Go直写 balances 表,一期PHP停写,用分布式锁防并发。
OpenIM登录同步 异步重试,不阻塞 登录成功 → 发Kafka/Redis消息异步创建IM用户;失败则指数退避重试。

🏗️ 五、整体逻辑拓扑

        ┌─────────────────────────────────────────────────────────────────┐
        │                      前端(原生双端)                          │
        └───────┬─────────────────┬─────────────────┬───────────────────┘
                │                 │                 │
                ▼                 ▼                 ▼
        ┌───────────────┐ ┌───────────────┐ ┌───────────────┐
        │  核心网关     │ │  OpenIM 集群  │ │  Lilishop     │
        │  (Go + Gin)   │ │ (即时通讯)    │ │ (黑盒, Java)  │
        │  端口:443     │ │  端口:TCP    │ │  端口:8080    │
        └───────┬───────┘ └───────────────┘ └───────────────┘
                │
                ├─────────────┬─────────────┬─────────────┐
                ▼             ▼             ▼             ▼
        ┌─────────────┐ ┌───────────┐ ┌───────────┐ ┌─────────────┐
        │  MySQL(RDS) │ │  Redis    │ │ 一期PHP   │ │ DeepSeek    │
        │ (二期核心表)│ │ (缓存+队列)│ │ (过渡调用)│ │ (Flash模型) │
        └─────────────┘ └───────────┘ └───────────┘ └─────────────┘
            
🔗 购物车/下单
前端 → Go网关 → 调Lilishop API查商品/扣库存 → 购物车数据存Go MySQL。
💬 社交/弹幕
前端 → Go网关 → 同步写OpenIM → 弹幕/评论先发后审(异步送广电)。
🤖 AI对话
前端 → Go网关 → 限流+排队 → 5秒超时兜底 → DeepSeek Flash。

🔒 六、底层硬性边界清单

以下内容将写入项目根目录 BOUNDARIES.md,所有AI生成代码必须遵守:

维度强制约束违反后果
数据库连接池Go: MaxOpenConns=50, MaxIdleConns=20RDS连接耗尽,服务熔断
HTTP超时调用Lilishop/一期PHP: 3s;调用DeepSeek: 5s超时中断,强制返回兜底
Redis缓存首页剧集列表缓存 10min;用户进度缓存 30min(写回MySQL)缓存失效时查库必须限流
DeepSeek限流单用户 1次/5s;全局限流 Flash 2500并发超出返回429,提示稍后再试
OpenIM消息单群 20条/s;单用户 5条/s超出丢弃并记录,防垃圾轰炸
广电审核异步队列积压超过 10,000条 触发报警人工介入扩容消费者
📌 AI编程启动提示词(强制注入)
“你现在是柠檬剧场二期Go服务的开发助手。硬性约束:所有HTTP调用超时不得超过3秒(外部AI为5秒);数据库连接池上限50;首页数据必须走Redis缓存(10分钟);金币扣减必须使用分布式锁;新增购物车数据存本地MySQL,禁止直接操作Lilishop数据库;所有OpenIM用户创建采用异步重试(指数退避);弹幕评论先发布后异步审核。每次生成代码前,请先检查是否符合上述边界,若不符合请主动指出并修正。”

⏳ 七、二期迁移时间线(双轨并行)

阶段时间核心动作Go覆盖范围
Phase 1第1-2周搭建Go网关,直连RDS(只读),完成金币余额重构。一期PHP暂停余额写入。资产服务
Phase 2第3-5周完成OpenIM集成+登录异步同步。原生端接入IM SDK。用户/社交基础
Phase 3第6-8周完成Lilishop黑盒对接+购物车自建表。原生端完成商品卡片渲染。电商服务
Phase 4第9-12周完成DeepSeek排队+缓存+弹幕审核异步链路。AI角色上线。AI/内容服务
Phase 5第13周全量切流,一期PHP下线(历史数据查询除外)。全量覆盖

🎯 八、总结与风险兜底

✅ 已覆盖的AI陷阱(80%)
分布式锁、防重放(二期补)、Redis缓存、超时熔断、异步审核、排队兜底、跨端进度同步、服务降级。
⚠️ 剩余20%风险
  • Redis雪崩(热点数据过期)
  • Lilishop黑盒超时
  • 队列积压导致OOM
🛠️ 应对策略
  • 缓存永不过期+后台刷新
  • 熔断器(Hystrix风格)
  • 队列深度报警+自动扩缩
🧭 下一步行动
可立即启动 Phase 1(金币余额重构) 的Go代码生成,或按模块分配开发任务。所有代码生成前请注入“AI编程启动提示词”,确保边界自动落地。