Files
Neo-ZQYY/docs/h5_ui/interactions/apply.md

2.4 KiB
Raw Blame History

页面名apply账号申请页

PRD 参考:apps/miniprogram/doc/prd.md 第七节 7.2P3 认证系统 已实现:是(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 提交入驻申请

页面导航

  • 来源loginstatus=new
  • 去向reviewing提交成功

全局组件

  • 无底部 TabBar
  • 无 AI 悬浮按钮