页面名:apply(账号申请页)
PRD 参考:apps/miniprogram/doc/prd.md 第七节 7.2;P3 认证系统
已实现:是(apps/miniprogram/miniprogram/pages/apply/)
页面说明
新用户提交入驻申请。顶部整合欢迎信息与审核流程步骤条,下方为结构化表单。
页面结构
- 顶部蓝色卡片:欢迎语 + 四步审核流程(提交申请 → 等待审核 → 审核通过 → 开始使用)
- 表单区域:5 个独立文本输入字段
- 底部固定提交按钮
状态变量
| 变量名 |
类型 |
初始值 |
必填 |
说明 |
| 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(提交成功)
全局组件