61 lines
2.4 KiB
Markdown
61 lines
2.4 KiB
Markdown
# 页面名：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 悬浮按钮
|