337 lines
12 KiB
Markdown
337 lines
12 KiB
Markdown
# 原 Vue Agency Center 逻辑清单
|
||
|
||
来源：
|
||
- `chatapp-h5/h5/js/index--RUKA0EA-1776148658686.js`
|
||
- `chatapp-h5/h5/js/pageConfig-BUpLPO7w-1776148658686.js`
|
||
- `chatapp-h5/h5/js/teamBill-BWXvrc1S-1776148658686.js`
|
||
- `chatapp-h5/h5/js/index-CIAVq8iD-1776148658686.js`
|
||
- 旧静态复刻：`chatapp-h5/h5/agency-center/agency-center.js`
|
||
|
||
## 页面初始化
|
||
|
||
- 初始化 i18n：读取当前 locale，并调用语言切换逻辑。
|
||
- 初始化 Vue Router。
|
||
- 初始化 identity store，并设置身份为 `AGENCY`。
|
||
- 清空 payee store。
|
||
- 使用 `usePageConfig("AGENCY_CENTER", { needsTeamInfo: true, forceRefresh: true, onDataLoaded })`。
|
||
- 页面 mounted 后触发：
|
||
- `identity = "AGENCY"`
|
||
- 获取银行卡列表
|
||
- 获取提现/KYC 信息
|
||
- 获取主播工资提现是否可用
|
||
- 清空收款人缓存
|
||
- `usePageConfig` 完成基础数据加载后执行：
|
||
- 获取团队成员数量
|
||
- 获取团队账单概要
|
||
- 获取当前用户成员工作汇总
|
||
|
||
## App 连接与请求头
|
||
|
||
- 判断是否在 App/WebView 环境。
|
||
- 如果已有连接且请求头缓存有效，复用缓存请求头。
|
||
- 如果未连接，调用 App bridge 获取 access origin 参数。
|
||
- 解析 App 返回参数后写入 HTTP 请求头。
|
||
- 关键请求头：
|
||
- `Authorization`
|
||
- `Req-Lang`
|
||
- `Req-App-Intel`
|
||
- `Req-Imei`
|
||
- `Req-Sys-Origin`
|
||
- 连接失败时可能跳转 `/not_app`。
|
||
- 新 `hyapp` 页面可沿用 Host Center 的 URL token 模式：从 `?token=` 或 hash query 读取 token，再转为 `Authorization: Bearer <token>` 请求 Java 接口。
|
||
|
||
## 用户与团队信息
|
||
|
||
### GET `/team/member/profile`
|
||
|
||
- 用途：获取当前用户信息。
|
||
- 显式查询参数：无。
|
||
- 依赖：`Authorization` 请求头。
|
||
- 原 Vue 展示或缓存字段：
|
||
- `id`
|
||
- `account`
|
||
- `userNickname`
|
||
- `name`
|
||
- `userAvatar`
|
||
- `ownSpecialId.account`
|
||
- `usePageConfig` 中写入 `userInfo`：
|
||
- `id = body.account`
|
||
- `account = body.account`
|
||
- `userNickname = body.userNickname`
|
||
- `userAvatar = body.userAvatar`
|
||
- 旧静态复刻中保留完整 `body` 到 `state.userProfile`，并缓存到 `localStorage.userProfile`。
|
||
|
||
### GET `/team/entry`
|
||
|
||
- 用途：获取当前用户所属团队入口信息。
|
||
- 显式查询参数：无。
|
||
- 依赖：`Authorization` 请求头。
|
||
- 原 Vue 使用 `body.teamProfile || body` 作为团队信息。
|
||
- 团队 ID 来源：`teamProfile.id || body.id`。
|
||
- 旧静态复刻缓存到 `localStorage.teamInfo`。
|
||
- `team/entry` 失败或空返回时，团队信息置空。
|
||
|
||
### GET `/team/bd-profile`
|
||
|
||
- 用途：获取当前用户所在团队关联的 BD 用户资料。
|
||
- 显式查询参数：无。
|
||
- 依赖：`Authorization` 请求头。
|
||
- 后端实现：当前登录用户 -> `TeamMember.teamId` -> `BusinessDevelopmentTeamService.getBdUserIdByTeamId(teamId)` -> `UserProfileDTO`。
|
||
- 原 Vue agency-center 未直接调用该接口；该接口由 Java 后端已有的 `TeamRestController#getTeamBdProfile` 提供。
|
||
|
||
## 身份与权限
|
||
|
||
### GET `/app/h5/identity`
|
||
|
||
- 用途：获取 H5 身份和路由权限。
|
||
- 显式查询参数：无。
|
||
- 原逻辑根据返回字段生成 roles：
|
||
- `freightAgent`
|
||
- `agent`
|
||
- `bdLeader`
|
||
- `bd`
|
||
- `anchor`
|
||
- `admin`
|
||
- 主角色优先级：
|
||
- `guest`
|
||
- `anchor`
|
||
- `agent`
|
||
- `bd`
|
||
- `bdLeader`
|
||
- `freightAgent`
|
||
- `admin`
|
||
- 默认跳转页：
|
||
- `admin` -> `/admin-center`
|
||
- `freightAgent` -> `/coin-seller`
|
||
- `agent` -> `/agency-center`
|
||
- `bdLeader` -> `/bd-leader-center`
|
||
- `bd` -> `/bd-center`
|
||
- `anchor` -> `/host-center`
|
||
- `guest` -> `/apply`
|
||
- Agency Center 允许 `agent` 访问；旧权限配置里 `freightAgent` 也允许访问 `/agency-center`。
|
||
- 如果当前路由不在允许列表中，跳转到主角色默认页。
|
||
|
||
## 工资/余额
|
||
|
||
### GET `/wallet/bank/balance`
|
||
|
||
- 用途：获取可用工资余额。
|
||
- 显式查询参数：无。
|
||
- 原 Vue `usePageConfig` 写入 `salaryInfo.currentSalary`。
|
||
- 展示字段：`$${salaryInfo.currentSalary}`。
|
||
- 原逻辑只在 `body` 是 number 时使用 `body.toFixed(2)`，否则展示 `0`。
|
||
- 请求失败时展示 `0`，并 toast：`Failed to load balance. Please try again.`
|
||
- 新页面如果展示 Agency 可用工资，优先复用这个数据源。
|
||
|
||
## 今日任务/主播任务
|
||
|
||
### GET `/team/member/work/statistics-now`
|
||
|
||
- 用途：获取当前用户今日工作统计。
|
||
- 查询参数：
|
||
- `dataType=DAILY`
|
||
- `memberId=<当前用户 id/account>`
|
||
- 原 Vue `taskInfo`：
|
||
- `anchorType = "Chat"`
|
||
- `minutesProgress = min(ownTime + otherTime, 120)`
|
||
- `minutesTotal = 120`
|
||
- `giftTask = acceptGiftValue || 0`
|
||
- 原 Agency Center 组件展示三个格子：
|
||
- `Host type`
|
||
- `Minutes`
|
||
- `Gift Task`
|
||
- 旧静态复刻里实际只展示 `Minutes`，`Host type` 和 `Gift Task` HTML 被注释。
|
||
|
||
## 成员工作汇总
|
||
|
||
### GET `/team/member-work`
|
||
|
||
- 用途：获取当前用户工作目标和结算汇总。
|
||
- 查询参数：
|
||
- `userId=<当前用户 id>`
|
||
- 原函数名：`fetchMemberWorkTotal`。
|
||
- 原逻辑：
|
||
- 读取 `body.targets || []`
|
||
- 跳过 `targets[0]`
|
||
- 再请求或读取 identity 判断身份
|
||
- 如果是 `agent`：累加 `target.settlementResult.ownSalary + target.settlementResult.memberSalary`
|
||
- 如果是 `anchor`：累加 `target.settlementResult.memberSalary`
|
||
- 写入 `memberWorkTotal = total.toFixed(2)`
|
||
- 注意：Agency Center 主模板里没有明确展示 `memberWorkTotal`，这是页面加载时保留的汇总逻辑。
|
||
|
||
## 团队成员数量
|
||
|
||
### GET `/team/members/count`
|
||
|
||
- 用途：获取团队成员数量。
|
||
- 查询参数：
|
||
- `id=<teamId>`
|
||
- 团队 ID 来源：`/team/entry` 的 `teamProfile.id || id`。
|
||
- 返回使用：
|
||
- `body.memberQuantity`
|
||
- 原点击 Team Member 时会把成员数量带到 URL：
|
||
- `/team-member?source=agency-center&members=<memberQuantity>`
|
||
- 请求失败时旧静态复刻 fallback 为 `87`，Vue 构建产物 catch 中也有相同 fallback。
|
||
|
||
## 团队账单概要
|
||
|
||
### GET `/team/bill`
|
||
|
||
- 用途：获取团队账单列表，Agency Center 首页只取第一条作为概要。
|
||
- 查询参数：
|
||
- `id=<teamId>`
|
||
- 原逻辑：
|
||
- 读取 `body[0]`
|
||
- `billBelong` 形如 `YYYYMM`，展示为 `YYYY.MM`
|
||
- `hostSalary = settleResult.memberSalary.toFixed(2) || "–"`
|
||
- `agentSalary = settleResult.ownSalary.toFixed(2) || "–"`
|
||
- `total = settleResult.totalSalary.toFixed(2) || "–"`
|
||
- 状态映射：
|
||
- `SETTLED` -> `Completed`
|
||
- `UNPAID` -> `In progress`
|
||
- `HANG_UP` -> `Out of account`
|
||
- `PAY_OUT` -> `Completed`
|
||
- 状态颜色逻辑：
|
||
- `In progress`：蓝色
|
||
- `Pending`：红色
|
||
- `Completed`：绿色
|
||
- `Out of account`：灰色
|
||
- 注意：Agency Center 首页初始化了 `teamBill`，但主模板只提供 Team Bill 入口，不直接展示账单卡片。
|
||
|
||
## 团队政策
|
||
|
||
### GET `/team/release/policy`
|
||
|
||
- 用途：Platform Policy 页面使用，不在 Agency Center 首页直接渲染。
|
||
- 查询参数：
|
||
- `id=<teamId>`
|
||
- 原 `PlatformPolicy` 通过 URL `from=agencycenter` 判断是否展示代理字段。
|
||
- 当 `from=agencycenter` 时，政策卡片展示：
|
||
- `time/hours`
|
||
- `target`
|
||
- `host_salary`
|
||
- `agent_salary`
|
||
- `total_salary`
|
||
- 线上 Java 接口需要参数名 `id`，不能用 `teamId`。
|
||
|
||
## 银行卡与提现信息
|
||
|
||
### GET `/wallet/bank-card/list`
|
||
|
||
- 用途：获取银行卡/收款方式列表。
|
||
- 显式查询参数：无。
|
||
- 原逻辑：
|
||
- `bankCards = body`
|
||
- `defaultBankCard = body.find(item => item.use) || null`
|
||
|
||
### GET `/wallet/withdraw-info/list`
|
||
|
||
- 用途：获取提现/KYC 信息。
|
||
- 显式查询参数：无。
|
||
- 原逻辑：
|
||
- 如果 `body.length > 0`，取第一条
|
||
- `passportFrontUrl` 按 JSON 字符串解析成 `previewUrls`
|
||
- 合并成 `withdrawInfo`
|
||
- 点击提现时如果 `withdrawInfo` 缺失，会弹出补全信息弹窗。
|
||
|
||
### GET `/wallet/bank/host-salary/withdraw/enabled`
|
||
|
||
- 用途：控制是否展示 `Cash withdraw` 入口。
|
||
- 显式查询参数：无。
|
||
- 原 Agency Center 仍然调用 `host-salary` 提现开关。
|
||
- 返回使用：
|
||
- `withdrawEnabled = Boolean(body)`
|
||
|
||
## 点击提现逻辑
|
||
|
||
- 计算值：`missingWithdrawInfo = withdrawInfo == null || defaultBankCard == null`
|
||
- 点击 `Cash withdraw`：
|
||
- 如果缺提现信息或默认银行卡，打开补全信息弹窗。
|
||
- 否则跳转 `/cash-withdraw`。
|
||
- 补全信息弹窗：
|
||
- 标题：`prompt`
|
||
- 主文案：`fill_info_tips`
|
||
- 辅助文案：`card_issue_tips`
|
||
- 按钮：`to_improve`
|
||
- 按钮跳转 `/agency-setting`
|
||
|
||
## 页面展示结构
|
||
|
||
- 顶部：
|
||
- `GeneralHeader`
|
||
- 标题：`agency_center`
|
||
- 右侧消息图标，点击跳转 `/message`
|
||
- 原 Agency Center 没有未读红点逻辑。
|
||
- 消息页：
|
||
- `Message` 页面 mounted 后请求 `/team/user/apply/record?teamId=<teamId>&status=WAIT`。
|
||
- 返回的 WAIT 记录作为待处理入团申请列表展示。
|
||
- 可在新 Agency Center 中复用该 WAIT 记录数量作为消息红点依据；原 Vue 没有单独的 unread 字段或 unread 接口。
|
||
- 原 Message 记录格式：
|
||
- `createUserProfile.userAvatar`
|
||
- `createUserProfile.userNickname`
|
||
- `createUserProfile.account`
|
||
- 操作按钮：`Agree`、`Refuse`
|
||
- 同意/拒绝接口：`POST /team/process/user/apply`，body 为 `{ id, status }`，`status` 可取 `AGREE` 或 `REJECT`。
|
||
- 工资卡片：
|
||
- 标题：`my_available_salary`
|
||
- 右侧按钮：`my_salary_details`
|
||
- 金额：`$${salaryInfo.currentSalary}`
|
||
- 今日任务卡片：
|
||
- 标题：`today_host_task`
|
||
- 原 Vue 展示 `Host type`、`Minutes`、`Gift Task`
|
||
- 旧静态复刻只展示 `Minutes`
|
||
- 菜单卡片：
|
||
- `Platform policy`
|
||
- `Exchange coins`
|
||
- `Transfer`
|
||
- `Cash withdraw`，受提现开关控制
|
||
- `Bank Accounts`
|
||
- `Team Member`
|
||
- `Team Bill`
|
||
- `Invite Members`
|
||
|
||
## 点击跳转
|
||
|
||
- 消息：`/message`
|
||
- 工资详情：`/history-salary`
|
||
- 平台政策：`/platform-policy?from=agencycenter`
|
||
- 兑换金币：`/exchange-gold-coins`
|
||
- 转账：`/transfer`
|
||
- 提现：`/cash-withdraw`
|
||
- 银行卡/收款信息：`/agency-setting`
|
||
- 团队成员：`/team-member?source=agency-center&members=<memberQuantity>`
|
||
- 团队账单：`/team-bill`
|
||
- 邀请成员：`/invite-members`
|
||
- 补全提现信息：`/agency-setting`
|
||
|
||
## 可复用到新 `h5/hyapp/agency-center` 的数据源
|
||
|
||
- 当前用户信息：`GET /team/member/profile`
|
||
- 可展示头像、昵称、UID、靓号。
|
||
- 当前团队信息：`GET /team/entry`
|
||
- 可取 agency/team 名称、teamId，并作为团队成员、账单、政策接口的前置数据。
|
||
- 当前团队关联 BD：`GET /team/bd-profile`
|
||
- 可展示 BD 的头像/昵称/账号等用户资料；旧 Vue agency-center 未直接调用，但后端已有接口。
|
||
- 当前余额/工资：`GET /wallet/bank/balance`
|
||
- 可作为 Agency Center 的 Salary。
|
||
- 今日工作数据：`GET /team/member/work/statistics-now?dataType=DAILY&memberId=<当前用户 id/account>`
|
||
- 可展示 Minutes，是否保留 Host type/Gift Task 需要按新设计决定。
|
||
- 团队成员数量：`GET /team/members/count?id=<teamId>`
|
||
- 可展示 Team Member 入口右侧数量，或用于跳转参数。
|
||
- 团队账单概要：`GET /team/bill?id=<teamId>`
|
||
- 可展示最近账单、Agent salary、Host salary、Total。
|
||
- 提现入口开关：`GET /wallet/bank/host-salary/withdraw/enabled`
|
||
- 可决定是否展示 Cash withdraw。
|
||
- 收款/提现信息：`GET /wallet/bank-card/list`、`GET /wallet/withdraw-info/list`
|
||
- 可决定点击提现时直接进入还是提示补充信息。
|
||
- 身份权限：`GET /app/h5/identity`
|
||
- 可判断是否为 `agent`，非代理时应避免展示代理中心主内容。
|
||
|
||
## 新页面实现注意点
|
||
|
||
- 新页面应放在 `h5/hyapp/agency-center/`，不要改旧 Vue 构建产物和旧 `h5/agency-center`。
|
||
- 视觉风格参考 `h5/hyapp/host-center`：浅绿色背景、圆角白色卡片、移动端固定宽度体验、URL token 请求。
|
||
- 先完成数据加载再决定展示代理中心或非代理状态，避免接口完成前闪跳。
|
||
- 如果需要非代理兜底页，应基于 `/app/h5/identity` 的 `agent` 字段判断。
|
||
- 如果继续使用政策接口，Java 线上接口参数必须是 `id=<teamId>`。
|