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/stat6. 建表(PostgreSQL 设计稿,仅参考不在本站执行)
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. 短链与跳转逻辑
- 生成:
/{type}/{relId}?inviter={uid}经签名后压缩为短码,落share_log。 - 访问:解析短码取原路径与邀请人,写入 30 天归因 cookie 后 302 跳转。
- 归因:被邀请人注册时读取归因,写
invite_record;满足完成条件后发积分并置finish_status=2。 - 去重:同一被邀请人只计一次;同设备或同 IP 高频注册进入风控待审。
8. 现有站点对应入口
- 移动端底部导航已存在,可直接承接询盘、订单、消息、我的四个入口
- 报价与询价页面已支持窄屏,无需重建
- 分享短链需服务端能力,前端先行提供复制链接与海报下载入口

