256 lines
5.9 KiB
Markdown
256 lines
5.9 KiB
Markdown
# BD Leader Center 原 Vue/旧 H5 逻辑清单
|
||
|
||
## 页面入口
|
||
|
||
- 旧入口：`h5/bd-leader-center/index.html`
|
||
- 旧逻辑：`h5/bd-leader-center/bd-leader-center.js`
|
||
- 旧公共工具：`h5/bd-static/shared.js`
|
||
- 相关子页面：
|
||
- `h5/agency-list/`：Agency list
|
||
- `h5/bd-list/`：BD List
|
||
- `h5/invite-agency/`：Invite to become agent
|
||
- `h5/invite-bd/`：Invite to become BD
|
||
- `h5/bd-item-distribution/`：Send welcome gift
|
||
- `h5/available-income/`：Available salary details
|
||
- `h5/policy/?from=BDLead`：BD Leader policy
|
||
|
||
## 鉴权和 App 通讯
|
||
|
||
- 旧逻辑优先通过 App bridge 获取 header：
|
||
- Android：`window.app.getAccessOrigin()`
|
||
- Flutter：`window.FlutterApp.postMessage("requestAccessOrigin")`
|
||
- 回调：`window.renderData`、`window.getIosAccessOriginParam`
|
||
- Header 会被解析为：
|
||
- `authorization`
|
||
- `req-lang`
|
||
- `req-app-intel`
|
||
- `req-imei`
|
||
- `req-sys-origin`
|
||
- `req-client`
|
||
- `req-version`
|
||
- `req-zone`
|
||
- 新 `hyapp` 页面沿用 Host Center 的 URL token 模式：
|
||
- 从 URL `token` 读取 token
|
||
- 请求头传 `Authorization: Bearer <token>`
|
||
- 同时传 `req-lang`、`req-client=H5`、`req-version=V2`、`req-zone`、`req-app-intel`、`req-sys-origin`
|
||
|
||
## 初始化流程
|
||
|
||
1. 设置语言和方向。
|
||
2. 清空旧提现收款人缓存：
|
||
- `sessionStorage.removeItem("payee")`
|
||
- `localStorage.removeItem("payee")`
|
||
3. 写入身份缓存：
|
||
- `localStorage.identity = {"identity":"BD_LEADER"}`
|
||
4. 获取基础资料：
|
||
- `GET /team/member/profile`
|
||
- `GET /team/entry`
|
||
- `GET /app/h5/identity`
|
||
5. 获取薪资总余额：
|
||
- `GET /wallet/salary-account/balance/total`
|
||
6. 渲染可用余额。
|
||
|
||
## 用户信息
|
||
|
||
接口：`GET /team/member/profile`
|
||
|
||
用途：
|
||
- 头像
|
||
- 昵称
|
||
- UID/账号/靓号
|
||
|
||
可参考字段：
|
||
- `id`
|
||
- `account`
|
||
- `userNickname`
|
||
- `name`
|
||
- `userAvatar`
|
||
- `ownSpecialId.account`
|
||
|
||
## 团队信息
|
||
|
||
接口：`GET /team/entry`
|
||
|
||
用途：
|
||
- 获取当前用户关联团队资料。
|
||
- 旧代码取值：`body.teamProfile || body`
|
||
|
||
可参考字段：
|
||
- `id`
|
||
- `teamId`
|
||
- `teamName`
|
||
- `name`
|
||
|
||
## 身份信息
|
||
|
||
接口：`GET /app/h5/identity`
|
||
|
||
用途：
|
||
- 判断当前用户身份。
|
||
- 旧路由配置包含：
|
||
- `bd`
|
||
- `bdLeader`
|
||
- `agent`
|
||
- `anchor`
|
||
|
||
BD Leader Center 旧实现不强制拦截，只把页面身份设为 `BD_LEADER`。
|
||
|
||
## 可用薪资
|
||
|
||
接口：`GET /wallet/salary-account/balance/total`
|
||
|
||
用途：
|
||
- 旧页面展示 `My available salary`
|
||
|
||
字段：
|
||
- `availableBalance`
|
||
- 其他余额字段以接口返回为准
|
||
|
||
旧页面展示：
|
||
- `$${availableBalance || 0}`
|
||
|
||
## BD Leader 成员账单 / BD List 数据
|
||
|
||
接口：`GET /team/bd/member-bill/list?type=BDLEADER`
|
||
|
||
用途：
|
||
- BD Leader 下属 BD 列表
|
||
- 当前账单周期标题
|
||
- BD 数量
|
||
- 团队薪资汇总
|
||
|
||
字段：
|
||
- `billTitle`
|
||
- `memberCount`
|
||
- `totalSalary`
|
||
- `memberBillList[]`
|
||
- `memberBillList[].agentAvatar`
|
||
- `memberBillList[].agentName`
|
||
- `memberBillList[].agentAccount`
|
||
- `memberBillList[].teamSalaryAmount`
|
||
- `memberBillList[].teamMemberCount`
|
||
- `bdHistoryCO`
|
||
|
||
旧 `h5/bd-list` 展示：
|
||
- `number_of_bd: memberCount`
|
||
- `team_salary: totalSalary`
|
||
- 每个 BD：
|
||
- 头像：`agentAvatar`
|
||
- 名称：`agentName`
|
||
- ID：`agentAccount`
|
||
- 团队薪资：`teamSalaryAmount`
|
||
- 代理数量：`teamMemberCount`
|
||
|
||
## Agency List 数据
|
||
|
||
接口：`GET /team/bd/member-bill/list?type=BD`
|
||
|
||
用途：
|
||
- Agency list
|
||
- BD 下属代理列表
|
||
- 团队充值/团队薪资/主播数
|
||
|
||
字段：
|
||
- `billTitle`
|
||
- `totalRecharge`
|
||
- `totalSalary`
|
||
- `memberBillList[].agentAvatar`
|
||
- `memberBillList[].agentName`
|
||
- `memberBillList[].agentAccount`
|
||
- `memberBillList[].teamSalaryAmount`
|
||
- `memberBillList[].teamRechargeAmount`
|
||
- `memberBillList[].teamMemberCount`
|
||
- `bdHistoryCO`
|
||
|
||
## BD Leader 历史收入
|
||
|
||
接口：`GET /team/bd/leader/history`
|
||
|
||
用途：
|
||
- 展示 BD Leader 历史收入弹层。
|
||
|
||
字段：
|
||
- `totalIncome`
|
||
- `previousPeriodIncome`
|
||
- `incomeDetails[]`
|
||
- `incomeDetails[].billTitle`
|
||
- `incomeDetails[].statusText`
|
||
- `incomeDetails[].billBelong`
|
||
- `incomeDetails[].bdNumber`
|
||
- `incomeDetails[].teamSalaryAmount`
|
||
|
||
状态映射：
|
||
- `UNPAID` / `In Progress` -> `In Progress`
|
||
- `Pending` -> `Pending`
|
||
- `SETTLED` / `PAY_OUT` / `Completed` -> `Completed`
|
||
- `HANG_UP` / `Out of account` / `Out Of Account` -> `Out of account`
|
||
|
||
## BD Leader 历史详情
|
||
|
||
接口：`GET /team/bd/leader/history/more?billBelong=<normalizedBillBelong>`
|
||
|
||
参数：
|
||
- `billBelong`
|
||
- 旧工具 `historyMoreUrl` 会把各种日期格式转换成：
|
||
- `YYYY-MM-DDTHH:mm:ss`
|
||
|
||
字段：
|
||
- `period`
|
||
- `teamSalary`
|
||
- `bdNumber`
|
||
- `memberDetails[]`
|
||
- `memberDetails[].bdUserAvatar`
|
||
- `memberDetails[].bdUserName`
|
||
- `memberDetails[].account`
|
||
- `memberDetails[].salary`
|
||
- `memberDetails[].agencyCount`
|
||
|
||
## 邀请 BD
|
||
|
||
入口：`/invite-bd`
|
||
|
||
接口：
|
||
- 列表：`GET /team/bd/invite-bd-message-own`
|
||
- 搜索用户：`GET /user/user-profile/open-search?account=<account>`
|
||
- 邀请：`POST /team/bd/invite-bd`
|
||
- body：`{ inviteUserId }`
|
||
- 取消邀请：`POST /team/bd/invite-bd-cancel/<id>`
|
||
|
||
## 邀请代理
|
||
|
||
入口：`/invite-agency`
|
||
|
||
接口：
|
||
- 列表：`GET /team/bd/invite-message-own`
|
||
- 邀请：`POST /team/bd/invite-agent`
|
||
- body：`{ inviteUserId }`
|
||
- 取消邀请：`POST /team/bd/invite-agent-cancel/<id>`
|
||
|
||
## 其他菜单功能
|
||
|
||
- `Details` -> `/available-income`
|
||
- `BD policy` -> `/policy?from=BDLead`
|
||
- `Agency list` -> `/agency-list`
|
||
- `BD List` -> `/bd-list`
|
||
- `Bank cards` -> `/bank-cards`
|
||
- `Send welcome gift` -> `/bd-item-distribution`
|
||
|
||
## 新 `h5/hyapp/bd-leader-center` 第一版实现范围
|
||
|
||
- 复用 Host Center 风格：
|
||
- 顶部状态栏和标题栏
|
||
- 用户资料卡
|
||
- 可用薪资卡
|
||
- BD 数量/团队薪资统计卡
|
||
- 功能入口列表
|
||
- loading mask
|
||
- 已接入：
|
||
- `GET /team/member/profile`
|
||
- `GET /app/h5/identity`
|
||
- `GET /team/entry`
|
||
- `GET /wallet/salary-account/balance/total`
|
||
- `GET /team/bd/member-bill/list?type=BDLEADER`
|
||
- `GET /team/bd/leader/history`
|
||
- `GET /team/bd/leader/history/more?billBelong=...`
|
||
- 已保留旧页面跳转入口。
|