# P34 积分、任务中心与签到激励体系

文档编号：pcbjia-P34-POINT-V1.0
状态：【评审通过】
定位：用轻量任务与签到拉动资料完善、询价发布、店铺维护与报价响应；积分只兑换平台内权益，不做现金提现。

---

## 1. 角色区分

- 采购买家：完善资料、发布询价、查看服务商、评价报价
- 供应商：完善店铺、上传资质与样品、报价、维护产能工艺、回复询盘
- 平台管理员：配置任务与积分规则、上架权益、查看流水

## 2. 每日签到

- 连续签到 1/2/3/5/7 天阶梯奖励，第 7 天后循环
- 断签重置连续天数，可消耗积分补签
- 签到日历与历史记录

## 3. 任务中心

一次性任务：

- 采购：完善企业资料、上传营业执照、完成账号认证、发布第一条询价、完成首次报价沟通
- 供应商：入驻提交、完善店铺、上传资质、上传样品图、设置主营工艺、完成首次报价

每日任务：登录、浏览服务商列表、查看 3 家工厂详情、发起 1 次询价、查看报价

每周任务：发布 2 条询价、评价报价、更新样品相册、更新产能、回复询盘不少于 5 条

## 4. 积分规则

- 每个任务独立配置积分值、上限、是否可重复、角色限制
- 扣减场景：兑换权益、违规处罚、撤销询价、恶意报价
- 有效期默认 12 个月，到期前提醒
- 兑换先冻结，生效后扣减，失败解冻

## 5. 积分商城权益

采购端：DFM 预审次数、Gerber 解析额度、优先线索推送、外贸单证导出次数
供应商端：店铺曝光加权、询价优先接单、展位折扣券、线索解锁额度

不提供现金提现，规避资金风险。

## 6. 流水与风控

- 全部变更留痕：签到、任务、兑换、扣罚、过期，可自助查询
- 短时间批量刷询价、提交空询盘刷积分由风控识别并撤销
- 同一设备多账号刷签到触发预警

## 7. 联动

- 消息中心：任务完成、积分到账、即将到期、兑换成功
- 权限：任务与积分配置独立权限
- 埋点：任务点击、签到完成、兑换转化
- 风控：任务行为校验与拦截

## 8. 优先级

- P0：签到、任务列表、积分流水、一次性任务、积分发放
- P1：每日与每周任务、有效期、商城兑换
- P2：补签、积分冻结、后台可视化配置
- P3：排行榜、月度活跃、企业子账号共享积分

## 9. 接口

```
POST   /api/v1/point/sign
GET    /api/v1/point/sign/calendar
POST   /api/v1/point/sign/patch
GET    /api/v1/task/list
POST   /api/v1/task/reward
GET    /api/v1/point/account
GET    /api/v1/point/log
GET    /api/v1/point/goods/list
POST   /api/v1/point/goods/exchange
```

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

```sql
CREATE TABLE task_config (
  id bigserial PRIMARY KEY,
  task_name varchar(255),
  task_type varchar(32),          -- once / daily / weekly
  user_role varchar(32),          -- buyer / supplier / all
  task_desc text,
  reward_point int DEFAULT 0,
  max_reward_times int DEFAULT 1,
  sort int DEFAULT 0,
  status smallint DEFAULT 1,
  created_at timestamptz DEFAULT now(),
  updated_at timestamptz DEFAULT now()
);

CREATE TABLE task_user_record (
  id bigserial PRIMARY KEY,
  user_id bigint NOT NULL,
  task_id bigint NOT NULL,
  task_date date,
  reward_point int DEFAULT 0,
  status smallint DEFAULT 1,
  created_at timestamptz DEFAULT now()
);
CREATE UNIQUE INDEX uk_task_user_date ON task_user_record(user_id, task_id, task_date);

CREATE TABLE user_sign (
  id bigserial PRIMARY KEY,
  user_id bigint NOT NULL,
  sign_date date NOT NULL,
  continue_day int DEFAULT 1,
  reward_point int DEFAULT 0,
  is_patch boolean DEFAULT false,
  created_at timestamptz DEFAULT now()
);
CREATE UNIQUE INDEX uk_user_sign ON user_sign(user_id, sign_date);

CREATE TABLE user_point (
  id bigserial PRIMARY KEY,
  user_id bigint NOT NULL UNIQUE,
  total_point int DEFAULT 0,
  frozen_point int DEFAULT 0,
  valid_point int DEFAULT 0,
  created_at timestamptz DEFAULT now(),
  updated_at timestamptz DEFAULT now()
);

CREATE TABLE point_log (
  id bigserial PRIMARY KEY,
  user_id bigint NOT NULL,
  change_point int NOT NULL,
  type varchar(32),               -- sign / task / exchange / deduct / expire
  rel_id bigint DEFAULT 0,
  remark varchar(255),
  created_at timestamptz DEFAULT now()
);

CREATE TABLE point_goods (
  id bigserial PRIMARY KEY,
  goods_name varchar(255),
  goods_type varchar(32),         -- dfm / quote / exposure / export
  need_point int DEFAULT 0,
  stock int DEFAULT 9999,
  limit_user_role varchar(32),
  status smallint DEFAULT 1,
  created_at timestamptz DEFAULT now()
);

CREATE TABLE point_exchange (
  id bigserial PRIMARY KEY,
  exchange_sn varchar(64) NOT NULL UNIQUE,
  user_id bigint NOT NULL,
  goods_id bigint NOT NULL,
  consume_point int DEFAULT 0,
  status smallint DEFAULT 0,      -- 0待生效 1已生效 2已撤销
  created_at timestamptz DEFAULT now()
);
```

## 11. 文案模板

- 签到成功：今日签到完成，连续签到第 N 天，积分 +X
- 任务完成：任务「{名称}」已完成，积分 +X
- 即将过期：你有 X 积分将在 30 天后过期，可用于兑换 DFM 预审次数
- 兑换成功：已兑换「{权益}」，权益将在 5 分钟内生效