五域

读完本页应能分清:哪几样按项目隔离,哪几样全平台共享,以及运营写接口和 C 端读接口各管哪一头。

后台管配置与治理;BaaS 把同一套能力交给 Web / H5 / App。路径与字段以 OpenAPI 为准。闭环状态见 闭环

账号域

后台消费端
能力会员列表、封禁、邀请、反馈、会话设备会话、账密 / 短信登录、me、改密、登出、并号
归属运营治理用户身份 按项目隔离
入口/api/v1/admin/users*/api/v1/auth/*/api/v1/app/me*

游客可看免费内容;付费墙再登录。封禁在登录 / me 以 403 BANNED 体现。

内容域

五类型:视频、漫画、小说、帖子、短剧。

后台消费端
能力导入、编辑、上下架、分类标签、短剧分集列表 / 详情 / 章节、播放凭证、分类标签
归属全平台共享内容池App 只出 on_shelf
入口/api/v1/admin/{videos,comics,novels,posts,dramas}*/api/v1/app/content/{type}play-ticket

已落地的边界:

  • 老司机同步 ≠ 进视频管理。
  • 短剧 / 连续剧不可直导视频列表;短剧走「加入短剧」。
  • 短剧拆集(source_episode_no ≥ 1)不出现在视频管理列表。

Studio 成片导入也进 catalog 短剧,见 内容管线AI 创作

支付域

后台消费端
能力套餐、订单、对账、支付渠道配置VIP / 金币档位、钱包、下单、内容解锁
归属商户与定价 按项目资金 不跨项目
入口Admin 支付相关路由`/api/v1/app/vip

写操作要带 Idempotency-Key。支付成功的唯一口径是服务端订单终态 paid,前端 Toast 不算。金额单位:分(整数);金币:整数。

通道:Mock 沙箱常在;公司 H5 支付 shark_pay 在环境变量配齐后挂载。见 闭环 · 钱

渠道域

后台消费端
能力渠道配置、归因查看落地页配置、归因绑定、邀请裂变
归属按项目POST /api/v1/app/channel/bind(终身锁定)

冷启动可以先不做买量,契约已预留落地页与绑定。

埋点域

后台消费端
能力总览、事件、漏斗、留存、质量POST /api/v1/events/batch
归属共享存储 + project_id标准事件名,专属数据放 properties

部分前置事件允许仅 API Key(匿名白名单)。项目不要自造事件名。

和多端的关系

五域都是 一套 Go API、多个客户端

  • Web / H5 直接调 BaaS。
  • 心跳榜的 Android 壳(Capacitor)调同一路径,可带 X-Client-Platform
  • 上头短剧的目标 App 是 Flutter,仍走同一套 BaaS 头与路径。
  • 运营后台走 Admin 面,不走 App JWT。