优化用户端首页服务归属展示

docs/03-用户端App需求.md

@@ -18,6 +18,7 @@
 | --- | --- | --- |
 | 定位 | 获取当前位置并允许手动选择地址/气站服务区域 | 授权失败有手动入口，不以定位失败阻塞设备使用 |
 | 内容 | 轮播图、公告、安全宣传、安全视频列表 | 后台上下架后按缓存策略刷新；外链有风险提示 |
+| 当前服务归属 | 分开显示“所属气站”和“服务配送点”，气站为主要信息、配送点为次要信息 | 不拼接组织名称；没有配送点时显示“服务方式：气站直接服务”；没有服务关系时显示明确空状态；组织名称最多两行 |
 | 智能瓶阀列表 | 显示名称、地址、在线状态、开关状态、最近告警、设备数量 | 可按地址/状态筛选；离线状态显著可见 |
 | 扫码添加 | 扫码或输入设备码，选择安装地址和设备昵称 | 校验设备归属、激活、服务区域和重复绑定 |
 | 设备接入 | 扫码添加、手动输入、蓝牙连接与设备校验 | 展示设备 ID、名称、安装位置；绑定前需用户确认，蓝牙权限失败有明确引导 |

docs/操作日志_用户端首页服务归属展示优化_20260902.md

@@ -0,0 +1,47 @@
+# 用户端首页服务归属展示优化操作日志
+
+操作时间：2026-09-02
+
+操作类型：修改、扩展
+
+影响模块：用户端 Flutter App 首页
+
+## 操作前状态
+
+首页将接口返回的气站名称与配送点名称直接拼接在“当前服务归属”下方，例如“薛海 1”。用户无法判断两个值分别代表气站还是配送点；无配送点与无服务关系也缺少明确说明。
+
+## 具体操作
+
+1. 根据确认的视觉方案一新增独立服务归属卡片，沿用现有安全蓝、白色卡片、圆角和间距令牌。
+2. 将气站和配送点拆分为“所属气站”“服务配送点”两行，气站名称使用主要信息字重。
+3. 无配送点时显示“服务方式：气站直接服务”；无服务关系时显示“尚未建立服务关系”。
+4. 组织名称限制为最多两行，超出部分使用省略号，避免破坏移动端布局。
+5. 新增固定数据的本地视觉预览入口，并在 390 × 844 视口完成两轮截图对照。
+6. 新增组件测试，覆盖完整关系、气站直服、无关系和长名称四种情况。
+
+## 操作后状态
+
+首页能够明确区分服务主体与履约网点，不再展示难以理解的拼接名称。功能仍只读，不新增点击、状态或接口字段，原有公告加载、刷新和底部导航行为保持不变。
+
+## 代码变更
+
+- `apps/user_app/lib/ui/features/home/home_page.dart`：替换旧的拼接展示，接入独立服务归属卡片。
+- `apps/user_app/lib/ui/features/home/service_relation_card.dart`：新增服务归属组件及空值处理。
+- `apps/user_app/test/ui/service_relation_card_test.dart`：新增四类组件测试。
+- `apps/user_app/tool/home_visual_preview.dart`：新增不依赖账号和网络的视觉验收入口。
+- `apps/user_app/design-qa.md` 与 `apps/user_app/design-qa/`：记录视觉验收基线、截图和对照结果。
+- `docs/03-用户端App需求.md`：补充首页服务归属展示规则。
+
+## 验证结果
+
+- `flutter analyze`：通过，无问题。
+- `flutter test`：通过，共 8 项测试。
+- `flutter build web --release --dart-define=API_BASE_URL=http://rest.heqiapp.com`：通过，已生成 Web 发布构建。
+- 390 × 844 页面视觉验收：通过；第二轮未发现 P0、P1、P2 问题。
+- 边界案例：已覆盖无配送点、无服务关系、长组织名称最多两行。
+
+## 风险评估
+
+- 影响范围仅限用户端首页展示层，不修改 API、数据模型、登录态或服务关系业务规则。
+- 组织名称超过两行时会省略尾部内容，这是为保证移动端布局稳定的预期行为。
+- 视觉预览使用固定示例数据，仅用于开发验收，不会进入生产路由或伪造业务状态。