注册资料与VIP准入

注册分两层判断:第一层是原来的4步资料,第二层是可动态开启的VIP准入。VIP可以视为页面流程中的第5页,但registrationStep继续只返回1–4,不把会员状态写成资料步骤5。

发行渠道与兼容

九个正式发行渠道各有独立开关,后台没有总开关;dev只在明确开发且非prod环境有独立设置。V28迁移逐项复制原全局值,不擅自开关。X-Channel及X-Platform沿用现有请求头,App的三个布尔字段不新增或改名,Flutter继续按vipRequired分流。

门槛按当前登录会话的发行渠道,而非首次注册归因、IP布局、国籍或界面语言。登录时绑定渠道和平台,后续访问/刷新须一致;同一账号在两个渠道可分别有会话,其VIP权益仍统一。旧NULL会话首次合法访问/刷新原子绑定,不批量退出旧用户。改渠道使用现有凭证返回401,需重新登录;未知渠道、平台与渠道不匹配或prod使用dev返回400 INVALID_APP_CHANNEL,不能作为关闭门槛放行。

渠道是客户端声明,绑定只能防同一凭证改头,不是商店安装验签。真实支付凭据仍须由服务端验证,不从渠道、前端回调或paid=true发放会员。

返回字段

验证码/三方登录、刷新、当前用户、保存注册草稿和完成注册的data均包含以下字段;不新增单独的进度接口:

字段 类型 含义
registrationStatus string INCOMPLETE或COMPLETE,仅表示资料是否已提交完成
registrationStep integer 第一层恢复页1–4,完成后仍为4
vipGateEnabled boolean 当前会话发行渠道VIP准入开关,默认false,配置改动后下次请求生效
vipActive boolean 当前服务端有效VIP;dev且非prod可由管理员测试值覆盖,否则使用已确认且生效、未过期、未撤销的权益
vipRequired boolean 资料已完成、开关开启且没有有效VIP时为true,表示必须进入VIP页

登录选项按请求渠道返回vipGateEnabled;登录后以用户响应的最新结果为准。配置仅影响该会话渠道的资料完成用户,包含既有账号及已登录会话;账号VIP权益跨渠道统一。关闭开关允许普通账号进入首页,但不会把vipActive改成true或赠送会员。

前端跳转顺序

if (data.registrationStatus !== 'COMPLETE') {
  openRegistrationPage(data.registrationStep); // 1国家、2资料、3语言生日介绍、4兴趣
} else if (data.vipRequired) {
  openVipPage(); // 第二层:需要服务端确认支付权益
} else {
  openHomePage();
}

第4步全部填写后,仍须调用完成注册。完成接口只把资料状态设为COMPLETE,返回的vipRequired决定下一页;它不生成VIP权益。旧nextStep=HOME现在仅说明第一层结束,不能单独用它跳过VIP判断。回到App或收到VIP_REQUIRED时通过既有当前用户刷新状态,不依赖永久缓存。

例如资料完成但需要付费:

{
  "registrationStatus": "COMPLETE",
  "registrationStep": 4,
  "nextStep": "HOME",
  "vipGateEnabled": true,
  "vipActive": false,
  "vipRequired": true
}
资料完成 开关 有效VIP 结果
否 任意 任意 先回到1–4中的资料页面
是 关闭 任意 首页
是 开启 否 VIP页
是 开启 是 首页

服务端拦截

服务端在每次带Bearer的业务请求重新读取当前会话渠道配置与账号权益。需要VIP时不授予普通业务权限,受保护接口(包括正式连接票据)返回HTTP403/VIP_REQUIRED;提示支持中英日韩。现有本人资料、完成注册、登录刷新、退出与头像接口仍可访问,保证用户能获取当前状态和完成资料。

{
  "code": "VIP_REQUIRED",
  "message": "请先完成支付并开通VIP,再进入主页。",
  "data": null,
  "errors": []
}

开关不是客户端权限,修改本地JSON、请求头或提交vipActive:true不会开通VIP。配置缺失或数据库错误返回503,不当作开关关闭;选择JWE的请求按原协议加密成功和错误响应。

当前已建立WebSocket连接的实时撤销仍待独立联动,本次拦截覆盖新HTTP请求及新票据申请,不宣称开关切换会即时关闭所有旧连接。

支付成功后的处理边界

真实支付接入后,必须先由服务端核验付款渠道、订单归属和支付结果,幂等落库权益;前端支付SDK显示成功不等于会员已到账。前端随后读取当前用户,仅在vipRequired=false且服务端已确认vipActive时,才按开启门槛的规则进入首页;回调尚未到达时停留在等待确认状态。支付取消、失败或校验失败不会发放权益。

目前支付下单、渠道回调/凭证核验、付费会员发放、退款联动、价格/期限及赠钻均未实现,VIP页仍是设计预览。本轮提供当前发行渠道开关、权益读取和准入判断;开关默认关闭。支付链路尚未接通前开启门槛,会让无权益用户停在VIP页,不能把测试权益当作真实支付成功。

渠道配置可由受控运维或独立管理后台授权操作,无需重新部署;后台修改带并发版本和审计。App用户不能通过公开接口修改当前发行渠道开关或自行标记付款成功。

已验证范围

2026-11-06已配套发布后端和各渠道配置网页,V27/V28生效。服务器clean verify共585项通过,0失败/错误/跳过;其中新增20项渠道门槛测试,覆盖九渠道独立判断、运行中开关、跨渠道共享账号权益、会话改头拒绝、刷新不消费错误渠道凭据、旧NULL会话原子绑定、独立时间版本和事务审计、四语/英文回退、未知渠道及平台不匹配,以及旧全局值为开/关时V27升级V28均保留。

真实入口28项只读检查通过:后台受信HTTPS/真实JWE/无Cookie拒绝/明文拒绝、十项渠道目录及四语名称、九正式渠道与开发dev的登录选项和后台值逐一一致、未知渠道四语及英文回退、App Store平台不匹配、旧无channel请求和未知渠道更新均400,前后全部开关与精确版本一致。业务配置写入0,未创建App测试账号、发放会员或改真实资料;本次临时管理员会话已退出。

原两层资料流程、到期/撤销/未来生效、付款引用唯一性、缺失策略503及审计失败回滚等完整回归继续通过。历史测试直接注入的付费权益只存在于隔离数据库;管理员开发测试覆盖见下文。真实支付、Flutter真机页面及已建立WebSocket即时VIP撤销尚未验收。网页布局与交互实际验收由管理后台当前进度记录,不把只读API检查等同于页面保存线上演练。

管理员开发VIP测试

为联调提供读取状态和设置/取消。仅服务器dev且非prod的OWNER可以操作,使用独立Cookie/CSRF/JWE、版本冲突检查及同事务审计。true强制VIP、false强制非VIP,持续到再次调整;无记录沿用付费权益。该覆盖按账号作用于各渠道,App原Token后续请求、刷新、me/home及后台列表读取同一结果,不修改资料步骤或渠道门槛。

覆盖单独保存,不创建或撤销付款记录,不代表付费成功/退款/赠钻;prod完全忽略覆盖并拒绝调整。注销删除非财务测试覆盖,但真实有效付费权益仍阻止注销。已有WebSocket即时撤销边界保持。