微信小程序页面迁移校验之前 P5任务处理之前

docs/h5_ui/interactions/apply.md

@@ -0,0 +1,60 @@
+# 页面名：apply（账号申请页）
+
+> PRD 参考：`apps/miniprogram/doc/prd.md` 第七节 7.2；P3 认证系统
+> 已实现：是（`apps/miniprogram/miniprogram/pages/apply/`）
+
+## 页面说明
+新用户提交入驻申请。顶部整合欢迎信息与审核流程步骤条，下方为结构化表单。
+
+## 页面结构
+1. 顶部蓝色卡片：欢迎语 + 四步审核流程（提交申请 → 等待审核 → 审核通过 → 开始使用）
+2. 表单区域：5 个独立文本输入字段
+3. 底部固定提交按钮
+
+## 状态变量
+| 变量名 | 类型 | 初始值 | 必填 | 说明 |
+|--------|------|--------|------|------|
+| siteId | string | "" | 是 | 球房ID |
+| role | string | "" | 是 | 申请身份（如：助教、店长等） |
+| phone | string | "" | 是 | 手机号 |
+| staffNo | string | "" | 否 | 编号（选填） |
+| nickname | string | "" | 是 | 昵称 |
+| loading | boolean | false | — | 提交请求中 |
+
+## 用户操作 → 响应
+| 操作 | 触发条件 | 响应行为 | 目标状态 |
+|------|----------|----------|----------|
+| 填写表单字段 | 无 | 更新对应状态变量；清除该字段错误状态 | 字段值更新 |
+| 点击"提交申请" | 表单校验通过 | POST /api/xcx-auth/apply | loading=true |
+| 点击"提交申请" | 表单校验失败 | 必填空字段高亮红框 + 下方红色提示文字，滚动到第一个错误字段 | 错误态 |
+| 提交成功 | API 返回 | 跳转 reviewing 页面 | redirectTo reviewing |
+| 提交失败 | API 报错 | Toast 提示错误信息 | loading=false |
+
+## 表单校验规则
+| 字段 | 规则 | 错误提示 |
+|------|------|----------|
+| siteId | 必填 | 请输入球房ID |
+| role | 必填 | 请输入申请身份 |
+| phone | 必填 | 请输入手机号 |
+| staffNo | 选填，无校验 | — |
+| nickname | 必填 | 请输入昵称 |
+
+## 页面状态枚举
+| 状态名 | 视觉表现 | 触发条件 |
+|--------|----------|----------|
+| 默认态 | 空表单，提交按钮可用 | 初始 |
+| 校验错误态 | 必填空字段红色边框 + 下方红色提示文字 | 校验失败 |
+| 加载中 | 提交按钮 loading | loading=true |
+
+## 后端 API 依赖
+| API | 方法 | 说明 |
+|-----|------|------|
+| `/api/xcx-auth/apply` | POST | 提交入驻申请 |
+
+## 页面导航
+- 来源：login（status=new）
+- 去向：reviewing（提交成功）
+
+## 全局组件
+- 无底部 TabBar
+- 无 AI 悬浮按钮