bug修复迭代

docs/frontend-practices.md

@@ -1,6 +1,6 @@
-# 员工端 H5 前端经验总结
+# 核销端 H5 前端经验总结
 
-这份文档记录当前员工端 H5 在页面规划、接口接入、移动端兼容、扫码核销和部署上的经验。后续改页面时，优先按这里的约定处理，避免重复踩坑。
+这份文档记录当前核销端 H5 在页面规划、接口接入、移动端兼容、扫码核销和部署上的经验。后续改页面时，优先按这里的约定处理，避免重复踩坑。
 
 ## 页面规划
 
@@ -8,21 +8,21 @@
 - 当前核心页面包括：登录、工作台、订单列表、订单详情、扫码核销、核销确认、核销结果、事件列表、发布事件、我的。
 - 工作台上的统计数据必须有明确后端依据。没有独立统计接口时，可以展示列表接口能稳定支持的指标，例如待确认订单、生效事件、近期订单、近期事件。
 - 不要把 mock 推导出的数据当成真实业务指标。比如订单表没有可直接查询的核销状态或核销时间时，不要在工作台展示“今日核销”这类指标。
-- 页面文案保持员工端视角，产品名称统一使用“员工端”。
+- 页面文案保持核销端视角，产品名称统一使用“核销端”。
 
 ## 登录与组织关系
 
 - 登录使用手机号验证码流程，登录成功后必须主动调用 `/hotelStaff/organizationMember/bindUserInfoAndGetUserMemberInfoByPhone` 获取当前用户组织关系。
 - 如果组织关系获取失败，统一提示“未绑定组织，请联系管理员”。
 - 当前不需要调用 `/user/checkUserHasBindPhone`。
-- 登录态只代表认证成功，不代表用户一定拥有员工端组织关系，业务页面入口应以后续组织关系接口成功为准。
+- 登录态只代表认证成功，不代表用户一定拥有核销端可用的员工组织关系，业务页面入口应以后续组织关系接口成功为准。
 - 接口返回“请求令牌已过期”、`401` 或 token 失效类错误时，要统一清理本地登录态并跳转 `/login`，同时带上当前页面作为 `redirect`，避免用户继续停留在失效页面。
 
 ## 接口路径
 
 - 所有真实接口都通过后端网关访问，由网关按路由转发到具体服务。
 - 本地开发使用 Vite proxy，当前开发网关是 `http://192.168.3.211:9999`。
-- 员工端接口前缀是 `/hotelStaff`，订单接口路径是 `/hotelStaff/order/...`，事件接口路径是 `/hotelStaff/event/...`。
+- 核销端使用的员工业务接口前缀是 `/hotelStaff`，订单接口路径是 `/hotelStaff/order/...`，事件接口路径是 `/hotelStaff/event/...`。
 - 登录接口走 `/auth`，验证码和用户相关接口走 `/admin`。
 - 不要在业务代码里硬编码完整网关地址，统一从环境变量和 `src/utils/env.ts` 读取。