UI 蓝图/Matrix X Chat · Communication/手机号 / 邮箱登录与设备验证

TARGETF4B2 PARTIALQA 0/5 VERIFIEDR12 · 13/21 PASS COMPLETEiOS · 首次登录、换机或会话失效的 Matrix X 用户

手机号 / 邮箱登录与设备验证

把账号、OTP、条款、设备验证与安全会话拆成可恢复的原生状态机

LoginView · AuthFlowmatrix-x-chat-ios对照 CURRENT · matrix-login →

R12 · KNIFE 13 / 21

手机号 / 邮箱登录与设备验证 · 原生页面级细化任务包

把账号、OTP、条款、设备验证与安全会话拆成可恢复的原生状态机。

CURRENT ROUTE

LoginView · AuthFlow

CURRENT SOURCE

MatrixXChat/Features/Auth/Login/LoginView.swift

CURRENT API

/app/api/auth/otp/send · login-user · verify-device

WORK MODE

authenticate · K12

ENTRY

首次登录、换机、session 失效或受控深链。

SUCCESS OUTPUT

得到服务端 session material 和设备状态后进入受控 AppRoot，不把验证码或 token 写入 UI 证据。

INTERACTION MODEL

Account → OTP challenge → device verification → session → registered return route。

A11Y

OTP one-time-code、VoiceOver、Dynamic Type、键盘焦点、错误摘要和 44pt 操作区。

TELEMETRY

auth_step_view · otp_request_result · device_verify_result；手机号、邮箱、OTP 与 token 脱敏。

CURRENT SOURCE + RUNTIMEiOS 257e604 · API 9e22253

matrix-x-chat-ios origin/main 为 257e604a5073b1ecab0f905d7ec59dfb78960639；本地 feat/p1-knives-1-8@56c8481 落后 main 86 个提交并有 3 个分支独有提交，不能作为最新 CURRENT
iOS main 可数 1,711 个 Swift 文件、617 个 `struct …: View`、682 个 Features Swift 文件、530 个 *Tests.swift 与 19 个 workflow 文件；App Store/TestFlight 采用哪个 build 本轮没有证明
im-core origin/main 与 EC2 production 均为 9e222534fcf6786a517f81936a2133bae7053e4d；源码有 225 个 Go 文件、78 个 Go test 文件、56 个 SQL migrations 和 405 个注册 HandleFunc
EC2 有 4 个 im-core runtime 容器加 PostgreSQL、Redis、NATS、MinIO；api.reits.tech 的 /healthz、/readyz、/api/v1/meta/app、/im/healthz 均返回 200，WebSocket 独立转发到 18081
主 App 锁定 Enterprise 1.0.47、Wallet 1.0.22、MiniApp 1.0.33、Plugin UI 1.0.34；新 tag 或插件仓最新代码不等于主 App 已消费
所有预览用户、会话、计数、游标、企业、动态、余额与小程序行情都是 REVIEW FIXTURE；只用于 UI/状态评审，不是生产数据或线上截图
生产 meta 明确 wallet_login、wallet_binding、EVM/TRON wallet login 全部 false；登录页不能展示可用钱包登录。

IMPLEMENTATION GAPPRODUCT QA 0 / 5

OTP 焦点、输入和非中文本地化 P0 仍需真机发布证据
缺 App Store/TestFlight exact build 与生产合成登录证据
登录后设备、session 和 revoke 的跨进程客户端收敛仍需验收

126-STATE PROGRAM / THIS SCREEN

九态挂在当前原生页面的数据、权限、游标、插件或回执上，不使用通用遮罩冒充交互完成

QA 0 / 5 VERIFIED

READYNativeAuthFlow 合同可评审

NativeAuthFlow native workspace

R12-AUTH-READY→ 检查 AuthFlow contract

LOADING正在读取 NativeAuthFlow

NativeAuthFlow independent regions

R12-AUTH-LOAD→ 保留原生导航上下文

EMPTY尚未输入账号，或没有可继续的 challenge

NativeAuthFlow result

R12-AUTH-EMPTY→ 查看合法下一步

PARTIAL ERRORNativeAuthFlow 部分依赖未收敛

NativeAuthFlow dependency rail

R12-AUTH-PARTIAL→ 只重试失败分区

ERRORNativeAuthFlow 请求失败

NativeAuthFlow request

R12-AUTH-ERROR→ 安全重试

OFFLINE离线只读 · NativeAuthFlow

NativeAuthFlow safe snapshot

R12-AUTH-OFFLINE→ 等待网络恢复

FORBIDDEN当前主体不能访问 NativeAuthFlow

NativeAuthFlow authorization

R12-AUTH-DENY→ 返回安全页面

CONFIRM确认在此设备建立新会话？

NativeAuthFlow impact sheet

R12-AUTH-CONFIRM→ 确认或取消

SUCCESSAuthRouteReceipt 已返回，等待 AppRoot 对账

NativeAuthFlow receipt

R12-AUTH-SUCCESS→ 查看回执

UI STUDIOtarget-matrix-login

iOS390 × 844100%

100%

LoginView · AuthFlow

TARGET UI390 × 844FIT 100%

R12 DESIGN CANDIDATEtarget-matrix-loginREVIEW FIXTURE · NOT LIVE DATA

9:41●●●　⌁　▰

E07 · NATIVE EVIDENCE OPENIOS SOURCE / CURRENT PROD API257e604 · 9e22253

API PRODUCTIONhealth/ready/meta/im-health 200IOS RELEASEApp Store build not proven

API PRODUCTION READY · build 9e22253 · CLIENT BUILD UNPROVEN

国家/地区🇸🇬　+65⌄手机号评审输入占位×

✓我已阅读并同意 服务条款 与 隐私政策

蓝图不调用真实 OTP；wallet login/binding 生产 capability 均关闭。

1账号2验证码3设备

REFERENCE VIEWPORT390 × 844Dynamic Type · safe area

PRIMARY TASK发送验证码主操作、权限与完成反馈必须同屏可验证

DATA CONTRACTNativeAuthRequestready / loading / empty / error 使用同一 fixture

ACCESSIBILITYVoiceOver + 44pt焦点顺序、可读名称、对比度进入 UI CI

VISUAL BASELINETARGET · 2026-07-18桌面/移动、浅色/错误态按稳定 Screen ID 留档

IMPLEMENTATION MAP

目标定义与下一轮逐页细化入口

当前处于 B1/B2：可以拆出架构、设计、交互和 QA 任务，但完成 D01–D12、通过 B3/B4 之前，不得宣称页面已经可以照稿实现。

01

页面区域

系统与 API 状态
品牌与信任
账号输入
条款与发送动作
验证进度
可访问性/P0 证据

02

用户动作

发送验证码
切换邮箱
粘贴/自动填充 OTP
重新发送
验证设备
取消登录

03

必须状态

通信状态已就绪
安全快照同步
当前范围为空
部分内容未同步
本次同步失败
离线只读快照
关系或权限不允许
高影响操作确认
服务端回执已完成

04

数据契约

NativeAuthRequest
OtpChallenge
DeviceVerification
SessionMaterial
AuthRouteReceipt
LocalizationKey

TARGET MODULES

目标页面必须交付的模块

01API/build 状态
02手机/邮箱切换
03国家区号
04条款同意
05OTP challenge
06设备验证
07安全会话
08P0 回归提示

PRODUCT ROUTE INDEX

Matrix X Chat · Communication 的 28 个稳定 Screen ID

同一产品内的页面共享 token、导航和状态语言，但每个 Screen ID 保留自己的字段、数据契约和 QA 基线。

登录入口LoginView · AuthFlow

会话列表MainTabView.chats · ConversationListView

聊天室AppRoute.chatById · ChatView

联系人MainTabView.contacts · ContactsListView

工作台MainTabView.workspace · PluginRegistry.workspace

全局搜索SearchView

新的朋友AppRoute.friendRequests · FriendRequestsView

群聊详情GroupChatDetailView

用户资料AppRoute.userProfile · UserProfileView

应用市场WorkspaceView · AppMarketView

朋友圈DiscoveryView · MomentFeedView

钱包AppRoute.wallet · WalletPluginHostView(.home)

设置与隐私MainTabView.profile · SettingsView

小程序容器PluginRegistry.miniApp · IMMiniAppViewShell

手机号 / 邮箱登录与设备验证LoginView · AuthFlow

会话、文件夹与未读收敛MainTabView.chats · ConversationListView

消息时间线、重放与发送回执AppRoute.chatById · ChatView

联系人、关系与群组入口MainTabView.contacts · ContactsListView

全局联系人、群聊与消息搜索SearchView

好友请求与并发关系决策AppRoute.friendRequests · FriendRequestsView

群资料、成员与权限控制GroupChatDetailView

联系人资料、隐私与会话授权AppRoute.userProfile · UserProfileView

企业工作台与应用编排MainTabView.workspace · PluginRegistry.workspace

企业应用市场与订阅WorkspaceView · AppMarketView

朋友圈媒体与可见性时间线DiscoveryView · MomentFeedView

钱包资产、资金动作与强认证AppRoute.wallet · WalletPluginHostView(.home)

账号、设备、隐私与本地设置总览MainTabView.profile · SettingsView

小程序可信运行容器PluginRegistry.miniApp · IMMiniAppViewShell

← 服务、来源、任务与存储 SLO 会话、文件夹与未读收敛 →