🍋 柠檬剧场 · 二期

技术方案框架 Go + Gin 微服务 原生双端 OpenIM · Lilishop · DeepSeek CP入驻 · 审核 · 分账
v3.1 · Mermaid 10.9.6 兼容
📅 版本日期 2026-08-01 👥 团队 2 Go + 1 PHP (转Go) 🎯 DAU目标 50,000 🧩 集成 OpenIM · Lilishop · DeepSeek 📦 部署 阿里云 ECS / RDS / Redis / OSS

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

柠檬剧场 是中国广电合作的短剧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 + 熔断降级。

📊 四、架构图集(Mermaid 渲染)

以下三张图分别展示 分层部署架构、服务依赖与数据流向、核心业务时序。图表使用 Mermaid 绘制,可右键另存为 SVG 或通过编辑器导出为 PNG。

图1 · 分层部署架构(物理/逻辑视图)
flowchart TB subgraph AccessLayer["接入层 - 用户端 & CDN"] iOS["iOS 原生 App"] Android["Android 原生 App"] CP_Web["CP 管理后台 Web端"] CDN["阿里云 CDN
视频/静态资源加速"] end subgraph GatewayLayer["网关层 - ECS 集群"] Gateway["Go + Gin 统一网关
鉴权 / 限流 / 熔断 / 路由"] end subgraph ServiceLayer["业务服务层 - Go 微服务 ECS 集群"] UserSrv["用户服务
登录/UnionID/IM异步同步"] ContentSrv["内容服务
短剧元数据/CP归属/状态机"] AuditSrv["审核服务
CP资质/短剧/商品绑定审核"] AssetSrv["资产服务
用户金币/分布式锁/日限额"] SettlementSrv["结算分账服务
CP账单/对公提现/分成"] SocialSrv["社交服务
弹幕/评论/剧群权限"] AISrv["AI陪伴服务
排队/缓存/5秒兜底"] EcomSrv["电商服务
本地购物车/卖家映射/下单编排"] end subgraph MiddlewareLayer["中间件与三方集成 - 独立 ECS/云服务"] OpenIM["OpenIM 集群
即时通讯
资源要求: ≥16核32G"] Lilishop["Lilishop 黑盒
SpringBoot + RocketMQ
卖家/商品/库存API"] DeepSeek["DeepSeek Flash API
大模型对话"] Audit_GD["广电内容审核接口
异步合规审查"] end subgraph DataLayer["数据与基础设施层 - 阿里云 RDS/Redis/OSS"] MySQL[("MySQL RDS
业务表/CP账户/本地购物车
读写分离")] Redis[("Redis 集群
缓存 / 延迟队列 / 分布式锁")] OSS["阿里云 OSS
短剧视频 / CP资质文件存储"] end subgraph LegacyLayer["遗留系统 - 过渡期"] PHP_LEGACY["一期 ThinkPHP 服务
仅限历史数据查询
调用超时 ≤500ms 熔断"] end iOS --> Gateway Android --> Gateway CP_Web --> Gateway Gateway --> UserSrv Gateway --> ContentSrv Gateway --> AuditSrv Gateway --> AssetSrv Gateway --> SettlementSrv Gateway --> SocialSrv Gateway --> AISrv Gateway --> EcomSrv UserSrv -->|"异步创建/同步鉴权"| OpenIM SocialSrv -->|"消息存储/群管理"| OpenIM ContentSrv -->|"触发审核"| AuditSrv AuditSrv -->|"调用合规接口"| Audit_GD EcomSrv -->|"商品查询/扣库存/卖家校验"| Lilishop EcomSrv -->|"同步CP为卖家(审核通过时)"| Lilishop AISrv -->|"限流排队调用"| DeepSeek UserSrv -->|"读写"| MySQL ContentSrv -->|"读写"| MySQL AuditSrv -->|"读写"| MySQL AssetSrv -->|"读写"| MySQL SettlementSrv -->|"读写"| MySQL EcomSrv -->|"读写"| MySQL AssetSrv -->|"分布式锁/队列/缓存"| Redis AISrv -->|"分布式锁/队列/缓存"| Redis SettlementSrv -->|"分布式锁/队列/缓存"| Redis ContentSrv -->|"视频转存/读取"| OSS Gateway -.->|"仅降级备用/历史数据"| PHP_LEGACY PHP_LEGACY -.->|"只读"| MySQL
💡 说明:展示各层组件部署位置、技术栈及物理资源要求,明确 OpenIM 与 Lilishop 分机部署,Redis 用于队列与分布式锁。
图2 · 服务依赖与数据流向拓扑(微服务地图)
flowchart LR subgraph GatewayLayer["网关层"] API["Go Gin Gateway"] end subgraph CoreServices["Go 核心微服务"] User["用户服务"] Content["内容服务"] Audit["审核服务"] Asset["资产服务"] Settlement["结算服务"] Social["社交服务"] AI["AI 服务"] Ecom["电商服务"] end subgraph ExternalDeps["外部系统/中间件"] IM["OpenIM 集群
即时通讯"] Shop["Lilishop 黑盒
商品/库存/卖家"] DS["DeepSeek Flash
大模型"] GD["广电审核接口
内容合规"] end subgraph StorageLayer["存储层"] DB[("MySQL RDS
读写分离")] Cache[("Redis 集群
缓存/队列/锁")] OSS["阿里云 OSS"] end API --> User API --> Content API --> Audit API --> Asset API --> Settlement API --> Social API --> AI API --> Ecom User -->|"读写用户表"| DB User -->|"异步创建IM用户 (Kafka/Redis)"| IM Content -->|"读写剧集/CP归属"| DB Content -->|"读取视频流"| OSS Content -->|"提交审核"| Audit Audit -->|"读写审核状态"| DB Audit -->|"调用合规接口"| GD Asset -->|"事务更新余额"| DB Asset -->|"分布式锁/限流"| Cache Settlement -->|"读取订单/广告明细生成账单"| DB Settlement -->|"触发CP提现任务"| Cache Social -->|"消息读写/群管理"| IM Social -->|"缓存热点弹幕"| Cache AI -->|"请求入队/超时兜底"| Cache AI -->|"调用对话"| DS Ecom -->|"本地购物车读写"| DB Ecom -->|"商品查询/扣库存/卖家校验"| Shop Ecom -->|"写入订单"| DB Ecom -->|"同步CP卖家信息(审核通过时)"| Shop
💡 说明:展示各服务与外部依赖的同步/异步调用关系,以及数据读写流向。
图3 · 核心业务时序图(关键链路)
sequenceDiagram autonumber participant CP as CP管理员 participant Portal as CP管理后台 participant Gateway as Go网关 participant Content as 内容服务 participant Audit as 审核服务 participant GD as 广电审核API participant User as 用户端App participant Ecom as 电商服务 participant Shop as Lilishop(黑盒) participant Settle as 结算服务 participant DB as MySQL participant Cache as Redis participant AI as AI服务 participant DS as DeepSeek participant Auth as 用户服务 participant IM as OpenIM rect rgb(230, 245, 255) Note over CP,GD: ① CP内容供给与审核链路 CP->>Portal: 上传短剧元数据+视频 Portal->>Gateway: 提交内容 Gateway->>Content: 创建短剧记录(cp_id, status=待审) Content->>DB: 写入剧集信息 Content->>Audit: 触发审核任务 Audit->>GD: 调用广电接口(异步) GD-->>Audit: 返回审核结果(通过/驳回) Audit->>DB: 更新status=已上架/已驳回 Audit-->>CP: 推送审核结果通知 end rect rgb(255, 245, 230) Note over User,Settle: ② 电商下单与分账链路 User->>Gateway: 提交订单(含CP商品) Gateway->>Ecom: 创建订单 Ecom->>Shop: 调用扣库存API Shop-->>Ecom: 库存扣减成功 Ecom->>DB: 写入订单(状态=待支付, cp_id冗余) Ecom->>Settle: 记录待分账明细(冻结态) Settle->>DB: 写入结算明细表 Ecom-->>User: 返回订单ID,跳转支付 Note over Settle,DB: 用户确认收货后,Settle将冻结态转待结算 end rect rgb(240, 255, 240) Note over User,DS: ③ AI陪伴对话(限流排队) User->>Gateway: 发送对话消息 Gateway->>AI: 转发请求 AI->>AI: 限流检查(单用户5s/次) AI->>Cache: 请求入队(带超时5s) alt 排队获取worker成功且<5s Cache-->>AI: 分配worker AI->>DS: 调用Flash模型 DS-->>AI: 返回AI回复 AI-->>User: 200 正常回复 else 排队等待 >= 5s AI->>Cache: 获取预置兜底话术 Cache-->>AI: 返回兜底文本 AI-->>User: 200 兜底回复(不计费) end end rect rgb(255, 240, 245) Note over User,IM: ④ 微信登录 + 异步创建IM用户 User->>Gateway: 微信一键登录(code) Gateway->>Auth: 换取UnionID Auth->>DB: 创建/更新本地用户 DB-->>Auth: 用户信息 Auth-->>User: 登录成功(token) Auth->>Cache: 发布异步任务(创建IM用户) loop 指数退避重试(最多5次) Cache->>IM: 调用创建用户API alt 创建成功 IM-->>Cache: 成功ACK else 创建失败(超时/网络抖动) IM-->>Cache: 失败 Cache->>Cache: 等待 1s,2s,4s,8s,16s end end Note over Cache,IM: 若最终失败,用户首次点击剧群时触发懒加载补偿 end
💡 说明:涵盖 CP 内容审核、下单分账、AI 排队兜底、登录异步同步 IM 四个关键链路,带超时与重试策略。

🔒 五、底层硬性边界清单

以下规则写入项目根目录 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条 触发报警人工介入扩容消费者
CP内容上架短剧 status 必须为 approved 才可被用户端检索未审核剧集直接展示,触发合规红线
商品绑定校验绑定的SKU必须属于该CP在Lilishop的卖家ID绑定其他卖家商品,引发财务纠纷
结算锁定CP结算账单生成后,该周期内订单数据禁止物理删除对账不平,法律风险
CP权限隔离CP管理员只能查询/修改 cp_id 等于自己的数据越权查看其他CP敏感商业信息
📌 AI编程启动提示词(强制注入)
“你现在是柠檬剧场二期Go服务的开发助手。硬性约束:所有HTTP调用超时不得超过3秒(外部AI为5秒);数据库连接池上限50;首页数据必须走Redis缓存(10分钟);金币扣减必须使用分布式锁;新增购物车数据存本地MySQL,禁止直接操作Lilishop数据库;所有OpenIM用户创建采用异步重试(指数退避);弹幕评论先发布后异步审核;CP内容必须审核通过才可见;商品绑定必须校验卖家归属;结算数据不可删除。每次生成代码前,请先检查是否符合上述边界,若不符合请主动指出并修正。”

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

重要调整:因 CP 角色引入,内容审核流优先级提升,Phase 1 变更为“内容与服务审核流重构”,确保 CP 上传能力先行。

阶段时间核心动作Go覆盖范围
Phase 1第1-3周内容与服务审核流重构(短剧CP归属、多级审核状态机、CP注册/资质审核),构建 CP 管理后台基础。内容服务、审核服务
Phase 2第4-6周OpenIM集成 + 微信登录异步同步,原生端接入 IM SDK,完成弹幕/评论基础能力。用户服务、社交服务
Phase 3第7-9周金币余额重构 + 新增 结算分账服务(CP账单、对公提现、分成计算),资产与结算一体化。资产服务、结算服务
Phase 4第10-12周Lilishop深度集成(卖家映射、商品绑定校验、购物车/下单完整链路),完成电商闭环。电商服务
Phase 5第13-15周DeepSeek排队+缓存+AI角色,弹幕审核异步链路,AI陪伴功能上线。AI服务
Phase 6第16周全量切流,一期PHP下线(历史数据查询除外),原生双端正式发布。全量覆盖

🎯 七、总结与风险兜底

✅ 已覆盖的AI陷阱(80%)
分布式锁、防重放(二期补)、Redis缓存、超时熔断、异步审核、排队兜底、跨端进度同步、服务降级、CP数据隔离、分账锁定。
⚠️ 剩余20%风险
  • Redis雪崩(热点数据过期)
  • Lilishop黑盒超时
  • 队列积压导致OOM
  • CP资质人工审核效率
🛠️ 应对策略
  • 缓存永不过期+后台刷新
  • 熔断器(Hystrix风格)
  • 队列深度报警+自动扩缩
  • 后台审核工作流+超时提醒
🧭 下一步行动
建议立即启动 Phase 1(内容与审核流重构) 的数据库表设计和Go代码开发。所有代码生成前请注入“AI编程启动提示词”,确保边界自动落地。