# 页面名: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 悬浮按钮