UI 蓝图/Matrix X Chat · Communication/好友请求与并发关系决策

TARGETF4B2 PARTIALQA 0/5 VERIFIEDR12 · 13/21 PASS COMPLETEiOS · 处理收到、发出与过期好友请求的用户

好友请求与并发关系决策

把来源、验证消息、过期、接受/拒绝/撤回和 relationship revision 明确呈现

AppRoute.friendRequests · FriendRequestsViewmatrix-x-chat-ios对照 CURRENT · matrix-friend-requests →

R12 · KNIFE 13 / 21

好友请求与并发关系决策 · 原生页面级细化任务包

把来源、验证消息、过期、接受/拒绝/撤回和 relationship revision 明确呈现。

CURRENT ROUTE

AppRoute.friendRequests · FriendRequestsView

CURRENT SOURCE

MatrixXChat/Features/Contacts/FriendRequestsView.swift

CURRENT API

/app/api/contact/list-all · accept · reject · cancel

WORK MODE

relationship · K12

ENTRY

联系人快捷入口、通知或 profile action。

SUCCESS OUTPUT

返回 DecisionReceipt；另一设备已处理或已过期时安全刷新。

INTERACTION MODEL

Request snapshot → expiry/revision → decision → idempotent receipt → relationship event。

A11Y

逐行按钮有完整名称，倒计时不高频播报，批量操作提供影响摘要。

TELEMETRY

friend_request_view · decision_result · conflict_refresh；不记录验证消息。

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/状态评审，不是生产数据或线上截图

IMPLEMENTATION GAPPRODUCT QA 0 / 5

请求数量、来源人物和到期时间都是 fixture
接受/拒绝必须绑定 relationship revision 并处理跨设备冲突
过期、撤回、拉黑并拒绝的负向矩阵尚未成为产品发布证据

126-STATE PROGRAM / THIS SCREEN

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

QA 0 / 5 VERIFIED

READYFriendRequest 合同可评审

FriendRequest native workspace

R12-FRIEND-READY→ 查看 concurrency rule

LOADING正在读取 FriendRequest

FriendRequest independent regions

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

EMPTY没有待处理或已发送请求

FriendRequest result

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

PARTIAL ERRORFriendRequest 部分依赖未收敛

FriendRequest dependency rail

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

ERRORFriendRequest 请求失败

FriendRequest request

R12-FRIEND-ERROR→ 安全重试

OFFLINE离线只读 · FriendRequest

FriendRequest safe snapshot

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

FORBIDDEN当前主体不能访问 FriendRequest

FriendRequest authorization

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

CONFIRM确认接受、拒绝、撤回或拉黑？

FriendRequest impact sheet

R12-FRIEND-CONFIRM→ 确认或取消

SUCCESSDecisionReceipt 已返回

FriendRequest receipt

R12-FRIEND-SUCCESS→ 查看回执

UI STUDIOtarget-matrix-friend-requests

iOS390 × 844100%

100%

AppRoute.friendRequests · FriendRequestsView

TARGET UI390 × 844FIT 100%

R12 DESIGN CANDIDATEtarget-matrix-friend-requestsREVIEW 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

好友请求

3待处理1即将过期0同步冲突

MK

Mika Tan

“你好，我们在 REITs 研究群见过。”

来源：群聊 · 3 分钟前

RW

Research Weekly

申请添加你为好友

来源：二维码 · 2 小时前

JL

Jordan Lee

“希望交流基础设施数据。”

来源：ID 搜索 · 23 小时前

REFERENCE VIEWPORT390 × 844Dynamic Type · safe area

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

DATA CONTRACTFriendRequestready / 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

页面区域

请求导航
状态分段
摘要
请求队列
逐行决策
revision 规则

02

用户动作

接受
拒绝
撤回
查看资料
拉黑并拒绝
重试冲突

03

必须状态

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

04

数据契约

FriendRequest
RelationshipRevision
RequestSource
RequestDecision
ExpiryPolicy
DecisionReceipt
RiskAction

TARGET MODULES

目标页面必须交付的模块

01待验证/已发送/已验证
02请求摘要
03来源
04验证消息
05到期时间
06决策 loading
07并发保护
08风险动作

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

← 全局联系人、群聊与消息搜索群资料、成员与权限控制 →