下载中心/方案说明

方案说明

下载原文件

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 设计稿,仅参考不在本站执行)

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. 现有站点对应入口

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