MAWflow 移动端用户手册
当前是否可用以及如何获取，统一查看 产品状态。
MAWflow 移动端用于在手机上处理确认、审批、验收和回修，让项目不因等待人工操作而停住。它不是完整桌面项目空间，也不用于发布和部署。
当前源码已通过 Vue 3 Web 构建与窄屏检查，但这不等于应用商店已经公开上架。请使用项目管理员提供的受控测试包或授权调试地址；没有安装入口时，继续使用桌面项目空间。
开始前准备
- 准备一个已注册并完成安全验证、且已加入目标项目的 Product Account；没有账号时可从移动登录页前往产品工作台注册。
- 确认你拥有对应事项的查看或处理权限。
- 首次使用相机、相册、文件或通知时，先阅读用途说明，再决定是否授权。
- 移动端会记住账号名称；密码只用于当次登录请求，不保存在内存会话或本机持久化存储。access token 只留在运行内存，轮换 refresh token 仅在平台提供安全存储能力时持久化；安全存储不可用时不会降级写入普通 Web Storage。
第一次成功
- 打开受控测试 App 或授权的 Web 调试入口并登录。
- 从“推进”或通知进入一个需要你处理的真实事项。
- 查看对象、项目、当前状态、对象版本、风险提示和允许动作。
- 填写处理理由并确认审批或测试结论。
- 提交时系统重新检查账号、项目权限、事项状态和对象版本。
- 成功后刷新页面，确认事项状态已改变，并能看到新的活动记录。
若页面提示状态冲突，不会覆盖别人刚完成的修改。请刷新到最新版，检查本地草稿后再次确认。
四个主要入口
| 入口 | 主要用途 |
|---|---|
| 推进 | 查看当前最该处理的事项、本人责任工作、协同提醒和快速录入。 |
| 项目 | 查看项目阶段、本人开发/变更责任、执行摘要和阻塞；可显式查看只读归档项目。 |
| 事项 | 区分可手机处理、只读关注和必须回桌面处理的事项。 |
| 我的 | 管理账号、主题、权限、版本、通知、诊断和本地草稿。 |
业务详情统一先展示“对象 → 状态与风险 → 下一步”。只有页面明确给出的动作可以在手机执行。
可处理事项与边界
| 事项 | 手机端行为 |
|---|---|
| 需求或任务草案 | 查看摘要并确认下一步；复杂编辑回桌面。 |
| 审批 | 填写说明、确认通过或驳回；提交前重新检查版本。 |
| 测试与复测 | 记录通过、失败或阻塞；失败可显式创建缺陷。 |
| 缺陷回修 | 查看执行摘要并请求轻量回修。 |
| 快速录入 | 提交需求、问题、任务、验收反馈或想法。 |
| 文件与证据 | 先检查上传用途、类型、大小和网络，再显示进度并上传。 |
| 发布、部署、回滚、源码和主机操作 | 永远只读，必须回桌面按正式流程处理。 |
移动端不会展示内部执行材料、未脱敏日志、服务器路径或访问凭据。
离线录入队列与草稿
快速录入属于低风险操作。网络不可用时，内容会进入有上限、有过期时间的离线录入队列；恢复网络并重新登录后，系统使用原请求编号逐项重试，避免重复创建。
审批、验收和回修会改变业务状态，因此它们的离线内容只保存为本地草稿，不会自动重放。你必须联网、重新登录、刷新对象版本并再次确认。状态冲突会单独标记，不能静默覆盖。
在“我的 → 设置 → 本地数据”中可以：
- 查看待发送录入、待确认草稿和冲突数量；
- 手动重试低风险录入；
- 取消不再需要的本地项；
- 清理已成功、已过期或已取消的记录。
队列会过滤密码、验证码、授权头和类似敏感字段；请仍避免在业务正文中粘贴凭据。
登录过期与安全链接
当登录过期时，App 会保存允许页面和安全对象编号，登录后返回原事项；保存目标不会包含密码或短期原始跳转凭据。
通知或二维码中的安全链接先进入核验页。系统检查账号、项目、对象和有效期后才打开目标；未知、过期、跨项目或无权限链接会拒绝，不根据链接内容猜测目标。短期原始跳转值仅在当前运行期间保留。
上传、权限与恢复
- 相机、相册、文件和通知只在你点击相关功能后申请。
- 拒绝权限后可前往系统设置恢复，也可使用粘贴或手动输入等替代方式。
- 文件上传前必须通过用途、扩展名、内容类型、大小、网络、平台能力和项目权限检查。
- 大文件在移动网络下可能被要求切换 Wi-Fi。
- 上传页会显示进度；可以取消，失败后重新选择并重试。
- 类型与扩展名不一致或属于危险类型的文件会被拒绝。
常见失败与处理
| 提示 | 原因 | 处理方式 |
|---|---|---|
| 登录已失效 | access/refresh 会话均已过期、被撤销或账号状态变化 | 重新登录，成功后返回原安全目标。 |
| 无权处理 | 未加入项目或角色不足 | 联系项目管理员，或回桌面查看可申请入口。 |
| 状态已变化 | 另一端已处理，或对象版本过旧 | 刷新对象，比较草稿，再次确认。 |
| 网络不可用 | 断网、弱网或服务暂不可达 | 低风险录入加入队列；状态动作只保存草稿。 |
| 链接不可用 | 链接未知、过期、跨项目或无权访问 | 返回推进首页，从最新通知或项目页重新进入。 |
| 上传被拒绝 | 类型、大小、网络或权限不符合策略 | 根据提示更换文件、网络或授权。 |
| 必须回桌面 | 动作风险较高或需要完整上下文 | 使用页面中的桌面入口继续处理。 |
隐私与诊断
- 本机只保存主题、语言、账号名称、安全路由、受限草稿、队列元数据，以及平台安全存储中的轮换 refresh token。
- 密码、access token、动态验证码和短期原始安全链接不做持久化；refresh token 不得降级进入普通 Web Storage。
- 诊断上传默认关闭；开启后也会过滤请求正文、凭据、路径和原始错误。
- 你可以在设置页单独清理诊断缓存，不会删除账号业务记录或离线草稿。
按官网步骤自测
- 打开 产品状态，确认当前获取方式和适用范围。
- 打开 App，确认启动时不会主动弹出相机、相册、文件或通知权限。
- 登录后打开一个真实事项，核对项目、对象、状态、对象版本、风险和允许动作。
- 完成一次审批或测试结论，刷新后确认源状态与活动记录已更新。
- 快速连续点击提交，确认只产生一次结果。
- 在另一端先处理同一事项，再用旧页面提交，确认出现状态冲突且不会覆盖。
- 断网提交快速录入，确认进入离线录入队列；联网后只创建一次。
- 断网填写审批或测试结果，确认只保存草稿，联网后仍要求重新确认。
- 重启 App，确认支持安全存储的平台可用轮换 refresh token 恢复会话；撤销或过期后必须重新登录，普通 Web Storage 中没有 token 或密码。
- 从安全链接进入；分别验证未知、过期、跨项目和无权限链接都会被拒绝。
- 选择文件上传，确认先出现策略结果与进度；取消后不会显示成功。
- 拒绝相机或文件权限，确认页面提供系统设置或替代输入方式。
- 切换浅色、深色和 393px 窄屏，检查四个主入口、按钮、键盘和安全区。
- 查看本地诊断和队列内容，确认不包含密码、动态验证码、短期原始跳转值或服务器路径。
仍需外部验收的事项
真实 iOS/Android 安装、商店审核、推送到达率、多设备长期离线、生产网络规模、企业移动设备管理和正式发布回滚，仍需在具体测试环境与设备上验收。仓库源码与 Web 构建通过不能代替这些外部结果。
下一步阅读
- MAWflow 项目空间说明：理解事项从哪里产生、状态如何回到项目。
- MAWflow PM 用户手册：理解需求、事项、活动和验收主账本。
- MAWflow Enterprise 用户手册：理解团队权限和高风险边界。