# P35 H5 移动端工作台与分享拉新

文档编号：pcbjia-P35-H5-INVITE-V1.0
状态：【评审通过】
定位：移动端轻量工作台，覆盖随时看询盘、收报价提醒、查订单、看工厂、快速发 RFQ；配套分享与邀请体系，与 P34 积分打通。

约束：PC 首页不改动；H5 与 PC 账号互通；只做高频操作，不搬完整 PC 功能。

---

## 1. H5 工作台

### 1.1 登录

- 手机号 + 邮箱 OTP（平台支持范围）；不接入第三方快捷登录
- 登录态与 PC 共用，同一账号数据一致

### 1.2 首页看板

指标：我的询盘、待处理报价、进行中订单、未读消息
入口：发布 RFQ、供应商库、工具、积分任务

### 1.3 采购端能力

- 简化 RFQ 发布（手机表单：工艺、层数、数量、交期、附件）
- 供应商列表与店铺（相册、视频、认证标签）
- 报价查看与站内沟通
- 订单进度、工单、积分签到
- Gerber 在线预览（轻量渲染，不做几何运算）

### 1.4 供应商端能力

- 新询盘提醒与手机快速报价
- 店铺资料维护、手机拍照上传样品
- 订单进度、客户留言、工单
- 签到、任务、积分商城

### 1.5 公共

- 供应商检索与筛选、阻抗与拼板计算器入口
- 帮助中心、客服悬浮入口
- 适配：手机与平板自适应；隐藏 PC 复杂菜单；图片自动压缩

## 2. 分享与邀请

### 2.1 分享物料

店铺、样品案例、RFQ、工具四类分享；生成带邀请参数的短链与分享卡片（标题、缩略图、简介）。

### 2.2 邀请规则

| 邀请人 | 被邀请人 | 完成条件 | 奖励 |
| --- | --- | --- | --- |
| 采购 | 采购 | 注册并发布首条 RFQ | 积分 |
| 供应商 | 供应商 | 完成入驻审核 | 积分 |

仅发放平台积分，可兑换 P34 积分商城权益，不发放现金。

### 2.3 记录与海报

邀请记录（被邀请人、注册时间、完成状态、奖励状态）；自动生成带二维码的海报，可保存分享。

### 2.4 防刷

同 IP、同设备、同手机号多次注册不重复发奖；异常行为联动风控拦截并撤销积分。

## 3. 消息推送

询盘、报价、工单、审核结果、积分到账提醒。浏览器通知可在用户授权后使用；微信公众号模板消息与短信邮件受平台能力限制，本期不实现。

## 4. 优先级

- P0：H5 登录、工作台、简化 RFQ、报价查看、消息通知、分享短链
- P1：邀请奖励与记录、裂变海报
- P2：轻量 Gerber 预览
- P3：排行榜、自定义分享素材

## 5. 接口

```
POST   /api/v1/h5/login
GET    /api/v1/h5/dashboard
GET    /api/v1/h5/rfq/list
POST   /api/v1/h5/rfq/submit
GET    /api/v1/h5/quote/list
POST   /api/v1/share/create
GET    /api/v1/share/record
GET    /api/v1/share/poster
GET    /api/v1/admin/invite/config/list
POST   /api/v1/admin/invite/config/save
GET    /api/v1/admin/invite/stat
```

## 6. 建表（PostgreSQL 设计稿，仅参考不在本站执行）

```sql
CREATE TABLE h5_menu (
  id bigserial PRIMARY KEY,
  menu_name varchar(128),
  route varchar(255),
  icon varchar(255),
  role varchar(32),                 -- buyer / supplier / all
  sort int DEFAULT 0,
  status smallint DEFAULT 1,
  created_at timestamptz DEFAULT now()
);

CREATE TABLE invite_config (
  id bigserial PRIMARY KEY,
  rule_name varchar(128),
  inviter_role varchar(32),
  invitee_role varchar(32),
  finish_condition varchar(32),     -- register / rfq / audit
  reward_point int DEFAULT 0,
  status smallint DEFAULT 1,
  created_at timestamptz DEFAULT now()
);

CREATE TABLE invite_record (
  id bigserial PRIMARY KEY,
  inviter_id bigint NOT NULL,
  invitee_id bigint NOT NULL UNIQUE,
  short_code varchar(64),
  invite_url varchar(512),
  finish_status smallint DEFAULT 0, -- 0未完成 1已完成 2已发奖
  reward_point int DEFAULT 0,
  created_at timestamptz DEFAULT now()
);
CREATE INDEX idx_invite_inviter ON invite_record(inviter_id);

CREATE TABLE share_log (
  id bigserial PRIMARY KEY,
  user_id bigint NOT NULL,
  share_type varchar(32),           -- shop / case / rfq / tool
  rel_id bigint,
  short_code varchar(64),
  click_count int DEFAULT 0,
  created_at timestamptz DEFAULT now()
);
CREATE INDEX idx_share_user ON share_log(user_id);
```

## 7. 短链与跳转逻辑

1. 生成：`/{type}/{relId}?inviter={uid}` 经签名后压缩为短码，落 `share_log`。
2. 访问：解析短码取原路径与邀请人，写入 30 天归因 cookie 后 302 跳转。
3. 归因：被邀请人注册时读取归因，写 `invite_record`；满足完成条件后发积分并置 `finish_status=2`。
4. 去重：同一被邀请人只计一次；同设备或同 IP 高频注册进入风控待审。

## 8. 现有站点对应入口

- 移动端底部导航已存在，可直接承接询盘、订单、消息、我的四个入口
- 报价与询价页面已支持窄屏，无需重建
- 分享短链需服务端能力，前端先行提供复制链接与海报下载入口