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

1. 需求背景

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

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

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

2. 需求目标

3. 影响范围

3.1 本期包含

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

4. 解决方案

4.1 需求方案

1. 未注册用户通过代理域名访问时，系统识别当前代理域名对应的代理线。
2. 当页面因折叠屏适配跳转至官方折叠屏域名时，系统须将原代理域名对应的来源信息一并传递至折叠屏官网。
3. 折叠屏官网接收并校验来源信息后，将对应代理归属写入本次注册会话；随后清除地址栏中的来源参数，用户最终仅看到官方折叠屏域名。
4. 用户在折叠屏官网完成注册后，后端根据本次注册会话中保存的代理归属，绑定会员上级代理；会员归属原代理线。
5. 用户直接访问官方折叠屏域名，未携带有效来源信息时，按现有逻辑注册并归属官网代理线。
6. 来源信息仅用于系统内部识别、校验及后台记录，前端注册页面不展示代理账号、代理线或来源参数。

4.2 示例

用户访问代理域名 vty72.net，触发折叠屏适配。

用户完成注册。

4.3 补充说明

1. 来源信息可通过 URL 参数在代理域名与折叠屏官网之间传递。
2. 来源参数采用可校验的签名字符串，避免直接暴露代理 ID 或原代理域名，并防止用户篡改代理归属。
3. 来源参数需关联原代理域名、对应代理线及站点信息，确保中站、越站来源不可混用。
4. 来源参数的具体格式、生成方式、校验及防篡改处理由开发评估实现。

4.4 注册会话规则

1. 每次通过代理域名跳转至折叠屏官网时，系统创建一次注册会话并保存本次代理归属。
2. 注册成功后，本次注册会话及待绑定的代理归属立即失效，不再作用于后续注册行为。
3. 用户如需再次注册，须重新通过代理域名进入并创建新的注册会话。
4. 单设备、同 IP、同手机号等注册多个账号的限制，沿用现有注册及风控规则，本需求不做修改。

4.5 注册归属规则

4.6 来源参数规则

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

5. 业务流程

6. 注册会话及异常处理

1. 未注册用户在折叠屏注册页填写信息期间，如刷新页面，本次注册会话中的代理归属应保留，不得变更为官网代理线。
2. 来源参数写入注册会话后，用户在当前注册页填写信息、获取验证码及提交注册过程中，不得因页面停留时间过长导致代理归属丢失。
3. 注册失败但未创建会员时，保留当前注册会话中的代理归属，用户修改信息后可再次提交。
4. 代理归属仅作用于本次通过代理域名进入的注册会话；用户直接打开官网链接、复制清除参数后的官网链接或新开官网页面时，不得继承该代理归属。
5. 来源信息存在但校验失败、代理域名无对应代理线或站点不匹配时，不得绑定其他代理线；前端提示：「当前注册链接异常，请重新通过代理链接进入」。
6. 注册成功后，会员上级代理关系以本次注册会话中保存的代理归属为准；本次注册会话及待绑定归属立即失效。
7. 用户从代理域名进入后，如注册前校验发现对应代理线已关闭、停用或删除，不得继续绑定该代理线；提示「当前注册链接异常，请重新通过代理链接进入」。

8. 代理域名转绑 / 转代

用户首次通过代理域名进入并成功写入注册会话后，以该次会话记录的代理归属为准；后续代理域名发生转绑，不影响本次注册归属。

例如：用户从 vty72.net 进入时属于代理 A；注册前该域名改绑代理 B，本次用户仍归属代理 A。下一个新用户再通过该域名进入时，才归属代理 B。

9. 网络相关

1. 跳转过程中网络中断、页面加载失败或用户刷新页面后，已写入的注册会话代理归属须保留。
2. 点击注册时网络超时，前端不得重复创建会员。
3. 网络恢复后，用户可继续当前注册流程，代理归属不得丢失。

10. 设备

• 用户将页面切换至后台、最小化或恢复前台时，本次注册会话中的代理归属保持不变。
• 用户在折叠、展开、横竖屏切换、分屏或调整浏览器窗口尺寸时，如触发折叠屏跳转，均须保留原代理归属。
• 用户更换设备、浏览器或无痕模式后，不继承原设备的注册会话；需重新通过代理域名进入。
• 用户在本次注册过程中切换网络或 IP 时，本次注册会话中的代理归属保持不变。

11. 已存在的会员

用户提交注册时，如果账号或者手机号已存在，按现有注册提示及登录逻辑处理；不得因本次来源信息重新绑定或修改该会员的上级代理。

7. 测试范围及验证项

本需求不新增会员后台管理系统及代理系统页面或配置项，重点验证折叠屏跳转后的代理归属及佣金归属是否正确。

7.1 注册及代理归属

1. 未注册用户通过代理域名进入，触发折叠屏跳转并完成注册后，会员上级代理应为原代理域名对应的代理线。
2. 未注册用户直接访问折叠屏官网并完成注册后，会员应归属官网代理线。
3. 已注册会员跳转至折叠屏官网后，原上级代理关系不变。

7.2 会员后台管理系统

1. 在会员列表及会员详情中，验证新注册会员的上级代理展示正确。
2. 验证会员归属的代理线与原代理域名对应关系一致。

7.3 代理系统及佣金

1. 验证新注册会员在代理系统中展示于正确代理线下。
2. 会员产生有效投注后，验证有效投注数据及佣金均计入正确代理线。
3. 验证不计入官网代理线或其他代理线。