chatapp-h5/h5/hyapp/host-center/original-vue-logic.md

原 Vue Host Center 逻辑清单

来源：

• chatapp-h5/h5/js/index-CN7d9oZS-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
• 后端参数定义参考 chatapp3-java/rc-service

页面初始化

• 初始化 i18n：读取当前 locale，并调用语言切换逻辑。
• 初始化路由对象。
• 初始化 identity store，并设置身份为 HOST。
• 清空 payee store。
• 使用 usePageConfig("HOST_CENTER", { needsTeamInfo: true, forceRefresh: true, onDataLoaded })。
• 页面 mounted 后并发或顺序触发：
  • 设置身份：identity = "HOST"
  • 获取我的代理资料
  • 清空收款人缓存
  • 获取银行卡列表
  • 获取提现/KYC 信息
  • 获取主播工资提现是否可用

用户信息获取

• usePageConfig 内部优先读取缓存用户信息。
• 非强制刷新时读取本地缓存用户资料。
• 强制刷新时请求 /team/member/profile。
• 页面展示用字段：
  • id
  • account
  • userNickname
  • name
  • userAvatar
  • ownSpecialId.account
• Host Center 当前代理/团长资料来自 /team/team-own/profile。
• 展示名称：userNickname || name
• 展示 ID：ownSpecialId.account || account
• 头像加载失败时走 imageHandler fallback。

App 连接与请求头

• 判断是否在 App/WebView 环境。
• 若已连接且缓存有效，复用缓存请求头。
• 若未连接，调用 App bridge 获取 access origin 参数。
• 解析 App 返回参数后设置 HTTP 请求头。
• 关键请求头来源：
  • Authorization
  • Req-Lang
  • Req-App-Intel
  • Req-Imei
  • Req-Sys-Origin
• 连接失败时可能跳转 /not_app。

路由与身份守卫

• 请求 /app/h5/identity 获取身份。
• 根据身份字段计算 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
• 当前用户没有 anchor 身份时跳到对应默认页。

收入/工资逻辑

• 可用工资来自 usePageConfig 的 salaryInfo.currentSalary。
• usePageConfig 会请求 /wallet/bank/balance。
• 响应 body 是 number 时展示 body.toFixed(2)。
• 请求失败时 currentSalary = 0 并 toast：Failed to load balance. Please try again.
• 原 Host Center 还请求 /team/member-work，用于获取历史工资和目标数据。
• /team/member-work 返回后：
  • historySalary 写入本地变量
  • 读取 targets[0]
  • 当前 hyapp/host-center 的 Work Time 使用 targets[0].target.onlineTime 作为总工作时长
  • 当前 hyapp/host-center 的 Target 显示 targets[0].target.acceptGiftValue 当前礼物积分
  • Target 点击明细使用 targets[0].target.dailyTargets[]，展示每日 dateNumber、acceptGiftValue、onlineTime
  • 结算状态映射：
    • SETTLED -> Completed
    • UNPAID -> In Progress
    • HANG_UP -> Out of account
    • PAY_OUT -> Completed
  • 目标等级取 target.settlementResult.level || target.level || "-"

今日任务/直播数据逻辑

• 原 Vue usePageConfig 会请求 /team/member/work/statistics-now。
• 请求参数：
  • dataType=DAILY
  • memberId=<当前用户 id/account>
• 原 Vue 今日任务展示逻辑：
  • anchorType = "Chat"
  • minutesProgress = min(ownTime + otherTime, minutesTotal)
  • minutesTotal = 120
  • giftTask = acceptGiftValue || 0
• 当前 hyapp/host-center 的 Work Time 不再用该接口，也不再限制 120；改用 /team/member-work?userId=<当前用户 id> 返回的 targets[0].target.onlineTime 总时长。

银行卡与提现信息逻辑

• 请求 /wallet/bank-card/list 获取银行卡列表。
• 取 body.find(item => item.use) 作为当前使用银行卡。
• 请求 /wallet/withdraw-info/list 获取提现/KYC 信息。
• 若 body.length > 0：
  • 取第一条
  • passportFrontUrl 按 JSON 字符串解析成 previewUrls
  • 合并到提现信息对象
• 请求 /wallet/bank/host-salary/withdraw/enabled。
• body 转 Boolean 后控制是否展示 Cash withdraw 入口。
• 点击提现：
  • 如果没有提现信息或没有当前使用银行卡，打开 infoMissing 弹窗。
  • 否则跳转 /cash-withdraw。

弹窗逻辑

• 弹窗状态：
  • infoMissing
  • leave
• maskLayerShow = infoMissing || leave
• 打开弹窗前先关闭其它弹窗。
• 点击遮罩关闭弹窗。
• infoMissing 弹窗：
  • 标题：prompt
  • 文案：fill_info_tips
  • 辅助文案：card_issue_tips
  • 按钮跳转 /host-setting
• leave 弹窗：
  • 标题：tips
  • 文案：leave_agent_tips
  • 取消关闭弹窗
  • 确认执行退出团队申请

退出团队逻辑

• 请求 /team/user/apply
• 方法：POST
• Body：
  • reason: "QUIT"
  • teamId: <当前团队 id>
• teamId 来源：
  • 原 Vue 使用 pe() 读取当前团队 id
  • 静态实现里曾兼容读取 teamInfo.id || agency.teamId || agency.id
• 失败时 toast errorMsg。

点击跳转

• 工资详情：/history-salary
• 平台政策：/platform-policy?from=hostcenter
• 主播设置/银行卡：/host-setting
• 兑换金币：/exchange-gold-coins
• 转账：/transfer
• 提现：/cash-withdraw
• 语言切换：/language
• 返回：
  • App bridge closePage
  • Flutter bridge close_page
  • 浏览器 history.back()

原接口与可传参数

GET /team/member/profile

• 用途：获取当前用户信息。
• 显式查询参数：无。
• 隐式参数：App 请求头中用户、语言、来源等上下文。

GET /team/team-own/profile

• 用途：获取我的团长/代理资料。
• 显式查询参数：无。
• 隐式参数：App 请求头中的当前用户上下文。

GET /team/entry

• 用途：获取当前用户团队入口信息。
• 显式查询参数：无。
• 返回中使用 body.teamProfile || body 作为团队信息。

GET /team/release/policy

• 用途：获取团队政策。
• 查询参数：
  • id: 团队 ID，必传。线上 Java 接口传 teamId 会返回 REQUEST_PARAMETER_ERROR: id required.
• 团队 ID 来源：
  • 优先使用 /team/entry 返回的 body.teamProfile.id
  • /team/team-own/profile 返回的 body.id 是团长/用户资料 ID，不是团队政策接口需要的团队 ID；直接传给 /team/release/policy?id=... 会返回 TEAM_NOT_FOUND
• 页面 URL 可以继续带 teamId 作为本地跳转参数，但真正请求 Java 接口时必须映射为 id=<teamProfile.id>。
• 返回使用：
  • body.policy[]
  • policy[].level
  • policy[].onlineTime
  • policy[].target
  • policy[].memberSalary
  • policy[].ownSalary
  • policy[].totalSalary

GET /team/search-account

• 用途：加入代理页搜索代理账号。
• 查询参数：
  • account: 用户输入的代理 ID/账号，必传
• 原 Vue ApplyView 使用：
  • 请求后判断 body.teamProfile
  • body.teamProfile.id 作为加入申请的 teamId

GET /team/wait-apply/profile

• 用途：获取当前用户待处理的加入代理申请。
• 显式查询参数：无。
• 原 Vue ApplyView 使用：
  • 有返回 body 时显示一条 pending 申请记录
  • 展示 body.ownUserProfile.userAvatar
  • 展示 body.ownUserProfile.userNickname
  • 展示 body.ownUserProfile.ownSpecialId.account || body.ownUserProfile.account

GET /wallet/bank/balance

• 用途：获取工资/银行卡余额。
• 显式查询参数：无。
• 返回可为数字，也可能为对象。

GET /team/member/work/statistics-now

• 用途：原 Vue 获取成员当天目标/工作统计；当前 hyapp/host-center 不再用它展示 Work Time。
• 查询参数：
  • dataType: DAILY | MONTH
  • memberId: 成员 ID，必传
  • size: 数量，可选
• Host Center 使用：
  • dataType=DAILY
  • memberId=<当前用户 id/account>

GET /team/member-work

• 用途：成员工资情况。
• 查询参数：
  • userId: 用户 ID，必传
• 返回使用：
  • historySalary
  • targets
  • targets[0].target.onlineTime，当前 hyapp/host-center 用作 Work Time 总时长
  • targets[0].target.acceptGiftValue，当前 hyapp/host-center 用作 Target 当前礼物积分
  • targets[0].target.dailyTargets[]，当前 hyapp/host-center 用作每日明细
  • targets[].status
  • targets[].target.settlementResult.level
  • targets[].target.level

GET /wallet/bank-card/list

• 用途：银行卡列表。
• 显式查询参数：无。
• 返回使用：
  • body[]
  • item.use
  • item.cardType
  • item.cardNo
  • item.payee

POST /wallet/bank-card/add

• 用途：新增收款方式。
• Body：
  • userId: 当前用户 ID
  • cardType: USDT | BANK
  • cardName: 收款方式名称；USDT 时原 Vue 固定为 USDT
  • cardNo: 卡号或 USDT 地址
  • payee: 收款人

POST /wallet/bank-card/use

• 用途：设置当前使用的收款方式。
• Body：
  • id: 收款方式 ID

GET /wallet/withdraw-info/list

• 用途：提现/KYC 信息列表。
• 显式查询参数：无。
• 返回使用：
  • body[0]
  • body[0].passportFrontUrl

GET /wallet/bank/host-salary/withdraw/enabled

• 用途：主播工资是否允许提现。
• 显式查询参数：无。
• 返回使用：
  • body boolean

GET /wallet/bank/check/exchange-gold

• 用途：检查当前用户是否允许兑换金币。
• 显式查询参数：无。
• 原 Vue ExchangeGoldCoins 用它做兑换入口权限检查。

POST /wallet/bank/exchange/gold

• 用途：把当前可用余额兑换金币。
• Body（原 Vue 主播兑换页）：
  • coinId: 金币档位 ID
  • amount: 美元金额
  • price: 美元金额
• Body（原静态逻辑页）：
  • amount: 美元金额
• 兑换比例未发现后端接口返回；原 Vue 金币档位是前端常量。

GET /wallet/bank/search/user-profile

• 用途：转账前搜索收款用户。
• 查询参数：
  • account: 用户输入的账号/ID
  • type: 原 Vue 传 AGENT
  • searchType: 转账场景传 TRANSFER

POST /wallet/bank/transferGold

• 用途：把当前可用余额转给其它用户。
• Body：
  • amount: 美元金额
  • acceptUserId: 收款用户 ID
  • acceptMethod: 原 Vue 主播转账传 BANK_TRANSFER

GET /app/h5/identity

• 用途：获取当前 H5 身份。
• 显式查询参数：无。
• 返回使用字段：
  • freightAgent
  • agent
  • bdLeader
  • bd
  • anchor
  • admin

POST /team/user/apply

• 用途：用户申请加入或退出团队。
• Body：
  • reason: JOIN | QUIT
  • teamId: 团队 ID，必传
  • url: 跳转 URL，可选
• Host Center 退出团队使用：
  • reason: "QUIT"
  • teamId: <当前团队 id>
• ApplyView 加入代理使用：
  • reason: "JOIN"
  • teamId: <GET /team/search-account 返回的 body.teamProfile.id>

POST /team/user/join-apply-cancel

• 用途：撤销待处理的加入代理申请。
• Body：
  • id: 申请记录 messageId，必传