﻿# 搞搞副业运营后台 & 广告主后台 V1 PRD

> 版本：V1.0
>
> 依据：2026-09-10 运营后台、广告主后台最新原型及现有接口约定
>
> 范围：运营后台、广告主后台；不包含达人端页面需求

## 1. 角色

| 角色       | 端         | 核心职责                                             |
| ---------- | ---------- | ---------------------------------------------------- |
| 平台运营   | 运营后台   | 管理广告主、项目、达人、推广对象、作品回填及运营配置 |
| 风控/审核  | 运营后台   | 审核关键词/群申请，查看异常和作品回填                |
| 财务       | 运营后台   | 处理结算、钱包流水和提现                             |
| 系统管理员 | 运营后台   | 管理后台账号、角色权限和操作日志                     |
| 广告主     | 广告主后台 | 查看合作项目、关键词/群创建结果、推广数据和结算确认  |

## 2. 全局规则

1. 两个后台独立登录、独立入口。
2. 列表支持关键词搜索、状态/项目筛选、分页；高风险操作必须二次确认。

## 3. 运营后台

### 3.1 登录与工作台

**登录**

- 字段：账号/手机号、密码、验证码。
- 支持获取验证码、登录、退出登录；登录失败提示原因。

**工作台**

- 预留

### 3.2 广告主管理

- 列表字段：广告主名称、联系人、手机号、项目数、状态、更新时间。
- 支持搜索、新增、编辑。
- 新增/编辑字段：广告主名称、联系人、手机号、状态、对接备注。
- 状态：合作中、待联调、暂停合作。
- 项目创建时必须关联有效广告主。

### 3.3 项目管理

- 列表字段：项目、广告主、项目类型、分类、接口配置、素材配置、教程配置、推荐、排序、状态、更新时间。
- 筛选：全部、草稿、待上线、投放中、已暂停、已下架；支持关键词搜索。
- 操作：新建、编辑配置、接口配置、素材库、教程/活动、上线、暂停、下架。
- 状态流转：草稿 → 待上线 → 投放中；投放中 → 已暂停/已下架；已暂停 → 投放中。
- 上线、暂停、下架必须二次确认并记录日志。

**新建/编辑项目字段**

| 分区     | 字段                                                                    |
| -------- | ----------------------------------------------------------------------- |
| 基础信息 | 项目名称、关联广告主、项目类型、项目分类、项目 Icon、项目简介、项目说明 |
| 首页展示 | 项目标签、是否推荐、分类排序、推荐排序                                  |
| 参与配置 | 是否加白、是否需要回填、回填说明、新增对象名称、项目状态限制            |
| 类型配置 | 拉群类：群名称规则；关键词类：关键词/别名模板、审核方、状态通知方式     |
| 奖励规则 | 任务要求、对接价格、达人奖励价格、展示标签、启用状态、排序；支持多条    |
| 详情说明 | 订单结算说明、风控/特别注意；支持展示开关                               |

规则：项目默认保存为草稿；未投放项目不展示给达人；上线前至少有一条启用的奖励规则；接口、素材、教程仅维护配置入口和配置状态。

### 3.4 达人管理

- 列表字段：达人昵称、手机号、实名状态、账号状态、参与项目数、总收入、可提现金额、最近登录。
- 筛选：正常、限制提现、已实名、未实名。
- 支持查看达人基础资料、项目参与、推广对象、收益和提现记录。
- 支持启用/禁用达人；禁用需填写原因，禁用后不可参与新项目、创建新推广对象和发起提现。

### 3.5 项目参与

- 一条记录对应一个达人参与一个项目。
- 列表字段：达人、项目、任务类型、项目状态、参与状态、加白状态、推广对象数、回填数、参与时间。
- 支持按项目和关键词筛选。
- “推广对象数”仅统计该达人在项目下创建的关键词/别名或企业微信群，不等同于推广数据、订单或回填数量。

### 3.6 关键词记录

- 适用：关键词类项目。
- 列表字段：关键词/别名、达人、达人 ID、项目、内容信息、招呼语、视频类型、广告主关键词 ID、回填数、平台审核状态、状态通知、预计过期、审核反馈、创建时间。
- 支持按项目、审核状态、关键词/达人/通知状态搜索。
- 操作：查看创建报文、查看状态通知。
- 状态：审核中、审核通过、已驳回、已停用。
- 审核通过、驳回、停用后，平台调用广告主状态变更接口；广告主不执行审核。

### 3.7 企业微信群记录

- 适用：拉群类项目。
- 列表字段：群名称、达人、达人 ID、项目、招呼语、平台审核状态、企微群 ID、二维码 ID、回填数、创建状态、失败原因、创建时间。
- 筛选：项目、审核状态、创建状态、关键词搜索。
- 状态分开记录：审核中/审核通过/已驳回；待创建/已创建/创建失败。
- 平台审核通过后调用广告主创建群接口；成功后保存群 ID和二维码；失败保留失败原因。
- 支持查看/下载二维码。

### 3.8 作品回填

- 列表字段：作品链接、平台、达人、项目、推广对象、状态、回填时间、备注。
- 平台筛选：抖音、快手、小红书、视频号。
- 支持搜索、筛选、分页和查看详情；V1 暂不提供作品回填数据导出。
- 回填不做前置审核；用于平台留档、合规检查和广告主分析。

### 3.9 推广数据

- 数据来源：广告主主动推送；
- 分页签：推广明细、API 接收记录、处理失败记录。
- 明细字段：数据 ID、推广时间、广告主、达人 ID、项目、推广对象、转化行为、记录类型、处理状态、金额、接收时间、异常原因。
- 处理状态：已接收、待生成订单、已生成订单、处理失败、幂等拦截。
- 处理顺序：格式校验 → 幂等校验 → 关联校验 → 按奖励规则计算 → 生成收益订单；失败进入失败记录。

### 3.10 收益订单与结算

**收益订单**

- 字段：订单号、推广数据 ID、广告主、达人、项目、转化行为、数量/金额、达人奖励、订单状态、结算周期、创建时间。
- 状态：待结算、已入批次、已结算、已作废。

**结算数据/批次**

- 字段：结算数据 ID、推广数据 ID、广告主、达人、项目、转化行为、金额、结算周期、状态、确认时间、入账时间、备注。
- 状态：待广告主确认、可入账/可结算、已入账、暂不结算。
- 广告主确认后进入平台结算队列；财务确认后生成达人钱包入账流水。
- 暂不结算必须填写原因；V1 暂不提供结算数据导出。

### 3.11 钱包提现

**钱包流水**

- 字段：流水号、达人、类型、金额、余额、时间。
- 类型：结算入账、提现冻结、提现成功等。

**提现申请**

- 字段：提现单号、达人、手机号、提现账户、金额、状态、申请时间。
- 状态：待处理、打款中、打款成功、打款失败、已驳回。
- 待处理支持通过/驳回；驳回原因必填。
- 通过后提交云账户打款；打款成功/失败以云账户接口回调为准，后台只展示结果。
- 详情展示手续费、处理时间、交易号、回调结果、操作记录。

### 3.12 消息、运营配置、系统管理

**消息通知**

- 类型：系统通知、项目通知、审核通知、结算通知、提现通知。
- 字段：消息 ID、类型、标题、发送对象、状态、发送时间。
- 支持新建草稿、发送；状态：草稿、已发送。

**运营配置**

- 首页分类：分类名称、是否展示、排序、备注；支持推荐、婚恋、小说、短剧、漫剧、网盘、AI、泛应用、游戏、知识。
- Banner：标题、跳转链接/项目 ID、图片、排序权重、启停状态。

**系统管理**

- 后台账号：姓名、手机号、角色、状态、最近登录；支持新增/编辑。
- 角色：管理员、平台运营、财务、风控/审核。
- 操作日志：日志 ID、操作人、角色、模块、动作、对象 ID、前后状态、时间、IP。

## 4. 广告主后台

### 4.1 登录与布局

- 字段：账号、密码；支持登录、退出登录。
- 页面：工作台、项目管理、关键词创建记录、企业微信群创建、推广数据、结算数据。
- 广告主后台不提供关键词审核、群申请审核、平台数据主动拉取或手动同步。

### 4.2 工作台

- 预留

### 4.3 项目管理

- 以卡片展示合作项目：项目名称、项目类型、合作状态、接口协作范围。
- 类型：拉群类、关键词类。
- 状态：合作中、待联调。

### 4.4 关键词创建记录

- 列表字段：请求 ID、关键词、达人 ID、项目、招呼语、广告主关键词 ID、平台审核状态、状态通知、创建时间。
- 支持按状态筛选、按关键词/达人 ID/项目搜索、查看详情。
- 状态：平台审核中、审核通过、已驳回、已停用。
- 广告主仅接收平台创建请求和状态变更通知，不可在本页面审核或修改状态。

### 4.5 企业微信群创建

- 列表字段：请求 ID、群名称、达人 ID、项目、招呼语、平台审核状态、创建状态、企微群 ID、二维码。
- 支持按状态筛选、按群名称/达人 ID/创建结果搜索、查看二维码。
- 平台审核通过后由平台调用创建接口；广告主返回群 ID和二维码。
- 创建状态：待创建、已创建、创建失败。

### 4.6 推广数据

- 数据由广告主主动推送至平台，本页只展示平台接收和处理结果。
- 指标：已接收、待生成订单、已生成订单、处理失败。
- 列表字段：数据 ID、推广时间、广告主、达人 ID、项目、推广对象、转化行为、记录类型、处理状态、金额、接收时间、异常原因。
- 不提供同步、主动拉取、手动补拉。

### 4.7 结算数据

- 列表字段：推广数据 ID、推广时间、项目、达人、推广对象、转化行为、金额、结算周期、结算状态、确认时间。
- 筛选：项目、结算周期、结算状态；支持搜索数据 ID、达人、推广对象。
- 仅“待广告主确认”可操作：
  - 确认可结算：进入平台结算队列。
  - 暂不结算：必须填写原因，状态更新为暂不结算。
- 其他状态仅查看详情。

## 5. 核心业务流程

### 5.1 关键词类项目

广告主提出需求 → 运营创建并上线项目 → 达人参与项目 → 达人提交关键词/招呼语 → 平台审核 → 平台调用广告主关键词创建接口 → 广告主返回关键词 ID → 平台通知广告主审核通过/驳回/停用 → 达人发布作品并回填 → 广告主按关键词归因并推送数据 → 平台生成订单 → 广告主确认结算 → 财务结算入账。

### 5.2 拉群类项目

广告主提出需求 → 运营创建并上线项目 → 达人参与项目 → 达人提交群名称/招呼语 → 平台审核 → 平台调用广告主企业微信群创建接口 → 广告主返回群 ID和二维码 → 达人进群推广 → 广告主按群归因并推送数据 → 平台生成订单 → 广告主确认结算 → 财务结算入账。

## 6. 接口要求

### 6.1 通用

- 请求头：`X-Api-Key`、`X-Timestamp`、`X-Nonce`、`X-Signature`、`X-Request-Id`、`X-Version`。
- 签名：HMAC-SHA256；时间戳允许误差 5 分钟；双方配置 IP 白名单。
- 所有请求必须支持幂等；敏感用户标识加密传输。

### 6.2 平台调用广告主

| 接口                                                     | 方向           | 关键字段                                                              |
| -------------------------------------------------------- | -------------- | --------------------------------------------------------------------- |
| `/open-api/advertiser/keywords/create`                 | 平台 → 广告主 | requestId、keyword、creatorId、greeting                               |
| `/open-api/advertiser/keywords/status-change`          | 平台 → 广告主 | requestId、advertiserKeywordId、creatorId、status、statusTime、reason |
| `/open-api/advertiser/enterprise-wechat-groups/create` | 平台 → 广告主 | requestId、creatorId、greeting、groupName                             |

### 6.3 广告主推送平台

`POST /open-api/platform/promotion-data/push`

- 必填：requestId、dataId、promotionType、creatorId、conversionType、conversionTime、recordType、updateTime。
- 关键词推广必传 advertiserKeywordId；群推广必传 advertiserGroupId。
- 修正数据新增记录，必须传 originalDataId、correctionReason；不得修改原始数据。
- 平台按 requestId 做批次幂等，按 dataId 做明细幂等；成功生成订单，失败返回失败原因。

## 7. V1 验收标准

1. 运营人员可登录并完成广告主创建、项目配置、项目上线/暂停/下架。
2. 关键词项目可完成关键词审核、广告主关键词创建、状态变更通知和结果查询。
3. 拉群项目可完成群审核、群创建、群 ID/二维码保存和展示。
4. 运营人员可查看作品回填、推广数据、失败原因和收益订单。
5. 广告主可查看合作项目、关键词/群创建结果和推广数据处理状态。
6. 广告主可对待确认结算数据执行“确认可结算/暂不结算”，后者必须填写原因。
7. 推广数据重复推送不重复生成订单；修正数据不覆盖原记录。
8. 结算确认后可生成钱包入账流水；提现通过/驳回、云账户回调状态可追踪。
9. 关键操作均可在操作日志中追溯。
