# 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=...`
- 已保留旧页面跳转入口。