中站 / 越站 · 产品需求 · v1.0

代理域名跳转折叠屏官网后保留代理归属

1. 需求背景

未注册用户通过代理域名访问时,若当前设备为折叠屏,或页面宽度达到现有折叠屏适配条件(屏宽 3.6 以上),页面会自动跳转到对应站点的折叠屏官方域名。

跳转后,原代理域名对应的代理归属没有被带过去。会员在折叠屏官网上完成注册后,默认挂到官网代理线,原代理拿不到该会员的佣金。

说明地址
原代理域名https://vty72.net
越站折叠屏官网https://fscreen.7cclive.com/
中站折叠屏官网http://fscreen.7tiadmin.com/

折叠屏适配的判定规则沿用现网。本期不调整触发条件,只补齐跳转后的代理归属。

2. 需求目标

用户从代理域名进入后,无论是否因折叠屏适配跳到官方折叠屏域名,完成注册后的会员都归属原代理域名对应的代理线。

不得因为域名跳转,把该会员归属到官网代理线。

3. 影响范围

3.1 本期包含

项说明
站点中站、越站
终端PC 浏览器、H5、App 内打开代理注册链接
用户仅未注册用户的本次注册归属
路径代理域名触发折叠屏适配,跳转到该站点折叠屏官网后完成注册

中站代理域名只跳中站折叠屏官网,越站代理域名只跳越站折叠屏官网。来源参数只在本站折叠屏官网内有效,不能跨站使用。

4. 解决方案

4.1 来源参数传递

  1. 用户通过代理域名进入时,系统识别该域名对应的代理线。
  2. 页面触发折叠屏适配并跳转到官方折叠屏域名时,跳转链接携带来源参数。
  3. 来源参数只承载原代理域名对应的代理归属,供系统内部传递和校验。
  4. 参数格式、生成方式、有效期、防篡改方式由开发评估。参数须能被服务端校验,不能靠随意拼接把注册归属到任意代理。

4.2 地址栏与页面展示

来源参数和代理归属只用于内部传递和校验。

代理域名→ 携带来源参数跳到折叠屏官网→ 官网保存本次注册归属→ 地址栏恢复为官网域名

4.3 注册归属规则

访问场景会员注册归属
通过代理域名直接注册原代理域名对应的代理线
通过代理域名,跳转折叠屏官网后注册原代理域名对应的代理线
直接访问折叠屏官方域名注册,未携带来源参数官网代理线
已注册会员登录或跳转域名保持原代理归属,不重新绑定

4.4 来源参数规则

  1. 来源参数由系统生成并校验,用户修改或伪造来源参数后,不得错误绑定至其他代理线。
  2. 折叠屏官网接收来源参数并保存本次注册的代理归属后,须自动清除地址栏中的来源参数;用户复制清除参数后的官网链接访问并注册时,会员归属官网代理线。

5. 业务流程

用户访问
↓
判断
是否已注册会员
↓
是
登录或跳转域名
保持原代理归属,不重新绑定
否 · 未注册
判断
从哪里进入
↓
直接打开折叠屏官网
未携带来源参数
注册后归属
官网代理线
通过代理域名进入
识别该域名对应的代理线
↓
判断
是否达到折叠屏适配条件
否
停留在代理域名直接注册
↓
归属原代理域名
对应的代理线
是 · 折叠屏或屏宽 3.6 以上
携带来源参数
跳转本站折叠屏官网
↓
校验来源参数
保存本次注册归属
↓
地址栏恢复为
干净官网域名
↓
在本次访问中完成注册
↓
归属原代理域名
对应的代理线

6. 功能需求

6.1 代理域名侧

编号需求
F01识别当前访问域名对应的代理线。识别不到代理线时,不携带归属跳转
F02仅在触发折叠屏适配跳转时,给折叠屏官网链接附上来源参数
F03中站只跳中站折叠屏官网,越站只跳越站折叠屏官网
F04PC、H5、App 内 WebView 使用同一套来源传递规则

6.2 折叠屏官网侧

编号需求
F05落地时读取并校验来源参数
F06校验通过后,把原代理归属写入本次注册会话
F07写入成功后,地址栏立即恢复为不带来源参数的官方域名
F08刷新干净域名、站内继续浏览后发起注册,归属仍以本次注册会话为准
F09注册页面及全站页面均不展示代理账号、代理线、来源参数、会员信息
F10注册提交由后端按本次注册会话绑定上级代理

6.3 注册绑定

编号需求
F11会话中存在有效代理归属时,新会员上级为原代理域名对应的代理
F12会话中没有有效代理归属时,新会员上级为官网代理线
F13已注册会员登录、访问、再次打开链接,都不改变已有上级
F14同一次访问只绑定注册当时会话中的归属,注册成功后不再用该归属改绑

7. 业务规则

编号规则
R01归属对象是「代理域名所对应的代理线」,不是域名字符串本身
R02来源参数只服务未注册用户的本次注册
R03参数校验失败、缺失、过期或被篡改时,不写入代理归属,注册按官网代理线处理,注册流程不中断
R04不得把无效参数绑定到错误代理
R05跨站参数无效。中站参数在越站、越站参数在中站,都按无来源处理
R06会话失效后,用户再次从干净官网域名进入,按直接访问官网处理
R07用户再次通过带有效来源参数的链接进入,重新写入本次注册会话
R08同一注册会话内,以最后一次校验通过的来源参数为准
R09代理域名未触发折叠屏跳转时,维持现有注册归属
R10清理地址栏失败时,页面上仍然不展示代理信息;归属以已写入的注册会话为准
R11来源参数的有效期、签名和存储位置由开发评估,须防止伪造归属
R12会话有效期须覆盖用户当次从落地到完成注册。具体时长沿用现有注册会话能力,由开发评估

8. 异常与边界

#场景期望
E01折叠屏设备从代理域名进入跳转携带来源参数,注册后归属原代理
E02非折叠屏设备,但屏宽达到 3.6 以上同 E01
E03屏宽未达到折叠屏条件不跳转,按现有代理域名注册归属
E04落地后地址栏已恢复干净,用户刷新再注册仍归属原代理
E05落地后用户站内跳转其他注册入口再提交仍归属原代理
E06用户直接打开折叠屏官网归属官网代理线
E07来源参数缺失、过期、篡改、跨站不绑定原代理,按官网代理线注册,页面不报错打断
E08已注册会员从代理域名被跳到折叠屏官网原上级不变
E09已登录会员打开带参链接不改绑上级
E10App 内 WebView 打开代理注册链接并触发跳转与 H5 相同:写入会话、注册归属原代理、界面不展示代理信息
E11来源参数对应代理已停用或不存在不绑定该代理,按官网代理线注册
E12注册请求重复提交会员只创建一次,上级只绑定一次
E13会话失效后再从干净域名注册归属官网代理线
E14地址栏参数清除前被复制分享其他未注册用户打开仍有效的来源链接时,按其参数归属注册;干净域名本身不携带归属

9. 验收标准

以越站为例,中站用 http://fscreen.7tiadmin.com/ 做同样验证。

#步骤通过标准
A01未注册用户访问 https://vty72.net,使用折叠屏或将页面宽度调到屏宽 3.6 以上跳转到越站折叠屏官网,注册完成后台上级为 vty72.net 对应代理,不是官网代理线
A02跳转落地后查看地址栏最终为 https://fscreen.7cclive.com/,来源参数不长期保留
A03地址栏恢复后刷新页面,再完成注册上级仍为原代理
A04查看注册页及落地页不出现代理账号、代理线、来源参数、会员信息
A05未注册用户直接打开折叠屏官网并注册上级为官网代理线
A06已注册会员从 https://vty72.net 跳到折叠屏官网上级代理与跳转前一致
A07PC、H5、App 内打开同一代理链接,并触发折叠屏跳转后注册三端新会员均归属原代理
A08中站代理域名触发跳转后注册上级为该中站代理,且落在中站折叠屏官网
A09篡改或使用过期来源参数后注册不绑定被伪造的代理,按官网代理线注册
A10屏宽不满足折叠屏条件,在代理域名直接注册归属与现网一致,仍为该代理

10. 开发评估项

以下不在本文档锁定实现,由开发按现有注册与域名体系评估。

项评估要求
来源参数格式与生成能唯一对应原代理线,服务端可校验,防止伪造
参数携带位置跳转链接上携带;落地校验通过后从地址栏移除
注册会话存储清除地址栏参数后仍可在本次注册中读到归属;注册接口不信任前端自报的代理 ID
会话有效期覆盖当次注册;失效后干净域名访问回到官网代理线
代理停用、域名解绑注册当时按 R11、E11 处理,不把会员绑到无效代理