润致GEO · 统一产品需求规格说明书 (PRD)

润致GEO是一个企业GEO（Generative Engine Optimization，生成式引擎优化）服务分销系统。系统采用多层级合伙人分销模型，通过"事业部 → 高级合伙人 → 城市合伙人 → 云创合伙人"四级架构实现服务推广与分润。

客户端和合伙人端共用同一个小程序，通过身份切换机制进入不同终端。两端的共享页面为：登录页和选择身份页。

运营平台端为独立PC Web应用，事业部与高级合伙人也可登录，但仅可查看自身管辖范围数据，不具有平台管理权限。

本文档合并了原三个终端的独立PRD，分为两大部分：

• 第一部分（第1-10章）全局规则：所有终端共用的业务规则、数据模型和流程定义。开发团队应首先阅读此部分。
• 第二部分（第11-13章）终端专属规则：各终端特有的页面规格和交互规则。

每个章节通过标签标注适用范围：三端 表示三端均适用；运营 / 客户端 / 合伙人 表示仅适用特定终端。

设计规范：三端统一的视觉与交互规范请参见根目录 design-system.html（v3.0），本文档不再重复颜色、组件、布局等UI细节。

1. 首次登录：用户通过手机号+短信验证码登录后，如无历史身份记录，跳转选择身份页，需选择「客户」或「合伙人」后才能进入对应首页。
2. 合伙人→客户：「我的」页面 → 点击「切换客户身份」→ 确认 → 进入客户端首页。
3. 客户→合伙人：同理可在客户端「我的」页面切换回合伙人身份。
4. 选择后记录：身份选择保存在服务端，下次登录直接进入上次身份对应的首页。
5. 切换不退出：身份切换不退出登录态，仅切换功能视图和数据范围。
6. 自购绑定规则：合伙人切换至客户身份下单时，系统自动将自己绑定为当前客户的上级合伙人；若该客户已有上级合伙人则不覆盖。

因小程序官方审核要求，账号未登录时也需允许用户访问首页。由于客户端和合伙人端共用同一小程序，访问规则如下：

差额累进模型：L1和L2的分润采用差额累进方式。即高级合伙人分润 = 订单金额 × (高级合伙人配置比例 − 下级合伙人实际分润比例)；事业部分润 = 订单金额 × (事业部配置比例 − 高级合伙人配置比例)。四个比例之和不作简单加法约束，而是通过差额模型自然分配。

城市合伙人独有权益：云创差价20%（直推云创推广产品收益的差价）和平级直推城市10%团队培育奖励，云创合伙人不享有此两项。

系统分润涉及四层账户，从上到下依次为：事业部(L1) → 高级合伙人(L2) → 城市合伙人(L3) → 云创合伙人(L4)。L1和L2采用差额累进方式分润。

1. 在产品管理 → 套餐管理中，为每个套餐配置标准价格和四级账户的分润比例。
2. 在产品管理 → 合伙人政策中，配置两个等级的升级费用、招商分润比例和间推招商分润比例。
3. 在产品管理 → 合伙人政策中，配置平级直推业务奖励、间推业务奖励及承担方。
4. 当合伙人切换至客户身份并为自己创建业务订单时，视同该合伙人的直推客户订单参与分润。
5. 产生分润的订单类型：合伙人升级订单 和 客户业务订单。

当合伙人A升级（或被招募的新合伙人B缴纳升级费），订单完成后系统生成以下分润记录：

当合伙人A的直推客户B购买GEO套餐时，系统生成以下分润记录：

以下为合伙人端用户可见的分润类型汇总（简化版，便于合伙人理解）：

分润按月在"分润账单"中结算，由运营平台核算后推送合伙人确认。

套餐由运营平台统一定义，包含以下字段：

以下为当前系统配置的套餐标准价和底价参考，实际以运营平台配置为准：

结算底价公式：平台标准套餐价 × (1 − 该等级合伙人直推业务分润比例)

合伙人和运营平台均可为每个客户独立设置套餐的可见性和专属价格。以最后一次修改为准。接口提交时需携带 updatedAt 时间戳做乐观锁校验，冲突时返回 HTTP 409。

可见性控制

• 合伙人在邀请客户时可勾选/取消勾选每个套餐，控制客户扫码后可见的套餐范围（1~4个套餐可选）
• 取消勾选的套餐对该客户不可见，不出现在海报和扫码后的选购页
• 默认所有套餐均设置为可见

自定义定价规则

• 合伙人可为每个客户、每个可见套餐设置独立的自定义价格
• 自定义价格默认等于平台标准价，合伙人可向上或向下调整
• 价格调整不得低于该合伙人对应等级的结算底价
• 生效范围：仅对新订单生效，已有订单和在服套餐不受影响

• 展示合伙人选择的 1~4 个套餐（运营平台已设为"不可见"的套餐已被全局过滤，不会出现在合伙人可选池中）
• 不展示"专属价格"徽章，不展示划线原价
• 合伙人标记的推荐套餐显示橙色"推荐"徽章并默认选中
• 支付方式：微信支付（线上）+ 银行转账（线下，支持企业对公账户或个人银行卡）
• 布局适配：2个套餐横向双列，3~4个纵向堆叠，1个单卡全宽也需展示选择页（不跳过）

• 微信支付：先创建订单，再调起支付：用户点击"立即支付"时，后端先创建订单（状态：待付款），返回订单ID；前端携带订单ID调起微信支付
• 微信支付成功：微信回调通知后端，后端更新订单状态为"待审核"；后端通知前端展示支付成功页
• 微信支付失败：订单保持"待付款"状态，用户可在"我的订单"中点击"继续支付"重试
• 支付取消：用户主动取消支付，订单保持"待付款"状态
• 银行转账：用户选择银行转账后，订单直接创建为待确认收款状态，用户上传付款凭证后由运营后台确认收款。
  业务订单：确认收款→待审核→已完成/已拒绝；确认未收款→已取消（记录原因）。
  合伙人升级订单（自行升级）：确认收款→直接已完成（免审核，身份立即生效）；确认未收款→退回待付款（必填备注，用户可重新支付）。

订单号全局唯一。订单完成后自动生成电子合同，合同文件在对应订单详情页可见可下载。

• 统一规则：企业当前套餐未过期时，续费的套餐无论是否与当前套餐一致（同套餐续费或跨套餐续费），统一为待生效状态
• 自动生效：待生效套餐必须在当前套餐过期后，才能自动生效。新套餐有效期从生效当日开始计算
• 一个企业最多一个待生效套餐：存在待生效套餐时，续费按钮置灰显示"已预约续费"，不允许再下新订单
• 确认弹窗：所有续费下单前均弹出确认弹窗，明确说明待生效时间点和生效规则
• 黄色提示区：所有续费下单时统一显示黄色生效时间提示区，动态展示当前套餐到期日和新套餐预计生效日
• 不涉及折算、不涉及退款

约束规则：若企业有生效中套餐，不能被其他用户重复添加。存在待生效套餐时不允许再下新订单。当前套餐已过期时，续费视为新购，无需待生效直接生效。

完整状态流转：

分润汇总账单：按月度汇总。包含总分润金额、手续费(4.5%)、应结算金额、分润人数、已确认人数、已结算人数。

分润账单（按分润方）：每个分润方每月一张。合伙人在小程序端确认，高级合伙人和事业部在运营平台端确认。

调增/调减：在账单完成前，运营平台可对分润金额进行调整。调整需填写说明并二次确认，调整后更新汇总数据。

1. 生成周期：按月生成，每自然月结束后出账，账单编号格式 RZ-BILL-YYYYMM-序号
2. 运营平台核对：平台运营人员在运营平台端对该月分润数据进行核对，确认无误后推送到合伙人小程序端
3. 合伙人确认：合伙人收到账单后，在小程序端查看分润明细，点击「立即确认」→ 短信验证(6位验证码)→ 确认生效
4. 财务结算：合伙人确认后，平台财务通过线下方式完成实际资金结算（银行转账等），结算完成后账单状态更新为「已结算」
5. 状态流转：待确认(pending) → 已确认待结算(confirmed) → 已结算(settled)
6. 手续费：结算金额 = 分润金额 × (1 − 手续费率)，当前示例费率 4.5%

流转规则：微信支付：待付款(0) → 待审核(1) → 已完成(2) / 已拒绝(3)。银行转账：待确认收款(5) → 待审核(1) → 已完成(2) / 已拒绝(3)；待确认收款(5) → 已取消(4)（运营确认未收款，需记录原因）。待付款(0)和待审核(1)阶段用户可主动取消→已取消(4)。首次下单需审核，续费自动通过。

多身份规则：一个用户可同时拥有"客户"身份和一种"合伙人"身份（云创或城市，不可兼得）。高级合伙人和事业部为运营组织架构身份，不与客户/合伙人身份共存于同一账号。

脱敏职责：后端存储原始值。接口返回时对小程序端请求返回脱敏数据，运营端请求返回原始值。

校验职责分工：后端必须执行全部校验规则并返回明确错误信息；前端作为辅助校验。以上校验标准为最低要求，不可在前端省略关键校验。

事业部管理

高级合伙人管理

权限说明：事业部和高级合伙人登录PC端后仅可查看自身业绩数据，不具有运营平台管理权限。高级合伙人登录后只能看到其管辖范围的合伙人和订单数据。

用户列表

新增用户规则：选择所属事业部（必填）→ 所属高级合伙人（必填）→ 上级合伙人（可选）→ 填写姓名/手机号/身份证号（必填）。身份默认为"客户"且不可在新增时修改。

编辑用户规则：仅支持编辑姓名、身份证号、结算账户名/账号、身份证正反面图片。身份和归属关系不可编辑。

升级操作：支持扫码升级（移动端）和后台升级。后台升级需选择等级、填写实付金额、选择是否参与系统分润、上传付款凭证。提交后创建升级订单（状态：待审核）。

合伙人升级订单

审核流程（运营后台创建的订单）：运营主管审核升级订单 → 通过则订单完成，身份变更生效，触发分润计算 → 拒绝则需上传退款凭证。

确认收款流程（用户自行升级-银行转账）：运营人员在升级订单列表对"待确认收款"订单进行确认——① 确认无误→订单直接完成，身份生效，触发分润（免审核）；② 确认未收到款项→必填备注→订单退回待付款，用户可在客户端"我的"页面看到退回原因并重新支付。

企业管理

代客下单：支持自定义有效期、实付金额、是否参与系统分润、上传付款凭证。提交后进入"待审核"状态。

产品订单管理

审核规则：首次下单需运营平台审核（触发待办事项），续费订单无需审核自动生效。银行转账订单需先在待确认收款状态下确认收款，再进行审核。

发票管理

客户在小程序端提交开票申请 → 运营平台审核 → 通过则上传发票文件 → 完成。拒绝需填写原因。

商学院与行业动态

内容管理模块。支持文章/资讯的增删改查、富文本编辑、分类管理、发布/草稿/下架状态切换。

企业套餐

系统管理

• 仅限邀请注册：用户需联系服务商获取邀请码，不支持自助注册
• 登录使用手机号+短信验证码
• 实名认证只需一次（身份证OCR），通过后可添加多个企业
• 企业添加成功即可下单，无审核流程

新用户引导流程状态机：

• 中断恢复：系统记录用户最后完成的步骤；下次登录时自动跳转到未完成步骤
• 未完成引导时的权限：可浏览首页和资讯（只读），但不能下单；"我的"页面显示引导进度
• 跳过逻辑：无跳过——实名认证和企业添加为下单的前置条件
• 步骤幂等：已完成的步骤不重复展示，用户可直接进入下一步

用户通过扫描合伙人分享的邀请二维码进入升级流程。升级页点击"确认升级"后依次进行4步状态机判断：

⚠️ 小程序仅支持手机号+短信验证码登录，不支持微信授权登录。注册和登录共用同一登录页面。