x/m-stecmd
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
m-stecmd/docs/E2E测试报告.md

27 KiB
Raw Permalink Blame History

E2E 测试报告 —— 监测数据不落地平台安卓客户端 M1–M6 全业务动线验收

任务：S-E2E 全业务动线端到端测试与验收报告（Heart 任务 00c8cc0d，父任务「M2–M6 全功能业务动线闭环与 E2E 测试」） 测试日期：2026-09-04 · 测试人：S-E2E 子会话（自动化 + 静态走查） 判定口径（任务书）：契约层 15 端点全覆盖 + 协议层覆盖确认 + UI 层完成（实机或静态推演）= 通过；任一层无法完成须写明阻塞与证据。

1. 结论速览

层 方式 结果 判定
契约层（15 在用端点 × 2 组负向） 真实请求实测（python3 脚本） 30/30 端点存在且响应形状闭环；A 组 14/15 双层结构成立，1 个服务端特例（2.14）；B 组验证密钥有效 + Token 门控全覆盖 通过
协议层（:ble-protocol） 静态覆盖矩阵 + gradle :ble-protocol:test 实测 静态审阅 IE-1000 五类 / VM208 六类用例全覆盖协议规格；实测 BUILD SUCCESSFUL，12/12 用例通过（本机无 JDK/Gradle，经临时装 JDK17 + 手动取 Gradle 8.10.2 发行版跑通，仓库零改动） 通过
UI 动线层 静态走查推演（降级，见 §5.1） 5 Tab 全部业务页、SessionState/ProjectSession 门控链、登录/配置/改密/采集/上传/统计状态机逐页核对，未发现门控缺口 通过（降级方式，已留证）

总体判定：三层验收通过（UI 层为静态推演降级口径）。 正向链路（真实凭据登录→项目→任务→采集→上传→统计）因无真实测试账号，仅梳理遗留项与移交建议（§7）。

2. 测试对象与环境

  • 应用：监测数据不落地平台安卓客户端，Gradle 多模块：:app（com.stec.cmd）、:core:network、:core:database、:core:ble、:core:common、:ble-protocol（纯 Kotlin JVM）。
  • 测试服务器：https://jcd.stec.p-q.co（接口管理规范 V4.5 测试环境；文档内 http://106.15.183.20:8006/ 为旧地址，以任务书为准）。
  • 契约依据：docs/上海城建勘测院监测数据不落地系统接口文档V4.5.docx（全文已解析核对）；功能点依据：docs/安卓客户端功能明细表.md（36 点，本期 M1 7 点 + M2–M6 25 点）。
  • 本机环境（Linux 沙箱）：无系统 JDK（java 不存在，docker.sock 无权限）→ 以 Adoptium Temurin JDK 17.0.20.1 tarball 临时安装于 /tmp；无 Android SDK（local.properties 为 Windows 路径且被 git 追踪，不可改）；heart_android_preflight 三次调用均 Premature close、heart_android_list_devices 30s 超时（MCP 通道异常，已留证）。
  • 密钥：docs/SystemCode_secertkey.txt / docs/appid_secertkey.txt（SystemCode:Mobile + SecretKey:<152 位 hex>），报告中只引用路径不落明文，探测响应存档中已脱敏。

3. 契约层（必做 · 负向）—— 15 端点真实请求

3.1 方法与用例组

  • 脚本：docs/e2e-evidence/contract_probe.py（python3 标准库，节流 1.5s/请求，不主动触发 403 锁定）。
  • 用例组 A：缺三要素头（SecretKey/SystemCode/Token 全缺）。
  • 用例组 B：带真实 SecretKey/SystemCode（运行时读密钥文件）、缺 Token；登录类端点按文档 1.2.3 天然无 Token，B 组等效「密钥正确 + 无会话」语义。
  • 判定：①存在性 = HTTP ≠ 404/000；②双层结构 = HTTP 500 且 body 含字符串字段 ExceptionMessage、其值可解析为含 code 的信封 JSON；③信封解包模拟 = code 为字符串且 ∈ {"200","500","429","403"}（对齐 core/network/ApiEnvelope.kt）。
  • 证据：原始响应 30 份存于 docs/e2e-evidence/responses/（A_2_2_1.txt … B_2_15.txt），机器可读结果 contract_results.json，汇总表 contract_evidence.md（均自动生成，与本节表格可交叉核对）。

3.2 证据总表（15 端点 × 2 组）

# 章节 端点（/OutWebApi/api/…） 方法 A 组 B 组 实测要点
1 2.2.1 LoginByAccount POST json 500+双层 ✅ 200+裸信封 用户名或密码错误！ A=密钥校验失败双层；B=密钥通过、业务层拒绝占位凭据
2 2.2.2 LoginSecurityCode GET 500+双层 ✅ 200+裸信封 短信验证码发送失败…（data.result=false） 参数合法进入腾讯云 SMS 发送流程（沙箱出网受限发送失败，属环境因素）
3 2.2.3 LoginByMobile POST json 500+双层 ✅ 200+裸信封 此号码的用户不存在… 业务校验直达
4 2.3.1 ModifyPassword POST json 500+双层 ✅ 500+双层 无效的token。 Token 门控
5 2.4 GetUserInfo GET 500+双层 ✅ 500+双层 无效的token。 Token 门控
6 2.5.1.1 GetProjectList GET 500+双层 ✅ 500+双层 无效的token。 Token 门控
7 2.6 GetUserPlanGroup GET 500+双层 ✅ 500+双层 无效的token。 Token 门控
8 2.7 GetPlanGroup GET 500+双层 ✅ 500+双层 无效的token。 Token 门控
9 2.9 GetPointBySurveyGroup GET 500+双层 ✅ 500+双层 无效的token。 Token 门控
10 2.10 GetPlanStatistical GET 500+双层 ✅ 500+双层 无效的token。 Token 门控
11 2.11 GetSurveyGroupList GET 500+双层 ✅ 500+双层 无效的token。 Token 门控
12 2.12 GetPointStatistics GET 500+双层 ✅ 500+双层 无效的token。 Token 门控
13 2.13 AnalysisMonitorData POST multipart 500+双层 ✅ 500+双层 无效的token。 multipart 体（含 Files 单文件）被服务端正常接收并进入鉴权
14 2.14 ControlPoint GET 500+纯文本 ⚠ 500+纯文本 ⚠ 服务端特例，见 §3.4
15 2.15 GetWorkPoint GET 500+双层 ✅ 500+双层 无效的token。 Token 门控

完整逐条数据（含 ExceptionType、信封 msg、data）见 docs/e2e-evidence/contract_evidence.md。

3.3 平台行为模型（实测归纳，修正任务书口径的适用范围）

  1. 鉴权失败 →「HTTP 500 + ASP.NET 异常包装内嵌信封」双层结构（与任务书/M1 实证一致）：
    • 密钥缺失/错误：ExceptionMessage = {"code":"500","msg":"认证未通过，请检查SystemCode与SecretKey的值是否正确","data":null}，ExceptionType=NK.Public.Exceptions.BusinessException，抛自 BaseApiController..ctor()；
    • Token 缺失/无效：同结构，msg=无效的token。。
  2. 业务失败 →「HTTP 200 + 裸业务信封」：带有效密钥的登录类端点实测返回 {"code":"500","msg":"…","data":null}（2.2.2 的 data 为 {"result":false}）。此路径不会出现双层结构——任务书预期中的双层结构仅适用于鉴权层负向。
  3. 信封解包模拟：全部 30 组响应中信封 code 均为字符串 "500"，与 ApiEnvelope.code: String 口径一致；客户端 ApiCaller.parseEnvelope 对「裸信封」与「双层包装」两种错误体均已兼容（core/network/src/main/kotlin/com/stec/cmd/core/network/ApiCaller.kt:55-77），实测形状全部可解。
  4. 密钥有效性正面验证：B 组登录端点能返回业务层错误（而非鉴权错误），证明 docs/SystemCode_secertkey.txt 中的密钥在测试环境有效、SystemCode=Mobile 与 SecretKey 匹配。
  5. 429（一分钟频控）未触发（30 次请求跨端点、1.5s 节流）；403（连续报错锁定）按约束未主动触发。负向「触发到哪个记哪个」口径下记为：本轮未触发，无观察值。

3.4 服务端缺口：2.14 ControlPoint 双重身份（基准点 2.14 / 工点数据 2.15 目录笔误）

  • 实测：/OutWebApi/api/ControlPoint（2.14 获取基准点）在缺密钥与缺 Token 两组下均返回 HTTP 500 + ExceptionMessage 为纯文本「当前用户不存在。」（ExceptionType=System.Exception，非 BusinessException、非内嵌信封）。该控制器在 action 内直接调用 UserService.GetCurrentUserInfo()，未走 BaseApiController 统一鉴权包装（StackTrace 显示 ControlPointController.Get 直取当前用户）。
  • 客户端影响：ApiCaller.parseEnvelope 解不出内嵌信封 → 退化为 ApiError.ServerError("500","HTTP 500")，UI 提示「操作失败，请稍后重试」。不崩溃、可用性无损，但错误文案退化，且与文档「双层结构」约定不符。
  • 建议：向院方/平台方反馈该端点的鉴权实现与统一异常包装不一致的问题（含本报告证据文件 responses/A_2_14.txt、B_2_14.txt）；客户端侧可考虑对该端点的 500 做文案兜底映射（可选优化，非阻塞）。
  • 说明：文档目录页将 2.15「获取工点数据」笔误为 ControlPoint，正文实测为 /OutWebApi/api/GetWorkPoint，客户端 PointApi.PATH_GET_WORK_POINT 与正文一致，本报告以正文为准（功能明细表 M5-03 已注记）。

3.5 端点在用性与文档目录核对

  • 文档 2.1 目录 15 个在用端点与客户端 core/network/api/*.kt 声明逐一比对完全一致（AuthApi×5、ProjectApi×1、TaskApi×2、PointApi×3、StatApi×3、UploadApi 在用部分×1）。
  • 废除端点 2.8.1 GetMonitorPoint、2.8.2 UploadMonitorValue：UploadApi.kt 中仍保留 PATH_UPLOAD_MONITOR_VALUE 常量与 uploadMonitorValue 声明，全工程无调用点（死代码，编译期保留不影响运行）；建议后续清理（非阻塞观察项）。
  • 文档 2.16 UploadAutomation（上传水位自动化数据）、2.17 GetPointsByPlan（按监测计划获取测点）不在本期 15 端点范围，客户端未实现，与功能明细表口径一致。

4. 协议层（必做）—— :ble-protocol 单测覆盖

4.1 静态覆盖矩阵（逐用例审阅源码）

IE-1000（帧 'Y'+4B 小端 float 压力+'T'+4B 小端 float 温度+0D 0A，固定 12 字节）——Ie1000FrameParserTest.kt（5 用例）：

规格点 测试用例 断言要点 覆盖
正常帧解析 整帧一次喂入解析出协议示例读数 协议示例 59 D8 BE 50 41 54 00 00 E8 41 0D 0A → 压力 13.0466（文档「13.04」为截断写法，测试按位模式 0x4150BED8 精确断言）、温度 29.0 ✅
截断/分片（残包） 逐字节分片喂入仍可切帧（残包容错） 逐字节 feed 12 次，最终恰好 1 条读数 ✅
粘包 粘包两帧一次解析 两帧拼接一次 feed → 2 条读数 ✅
脏帧重同步 脏帧被丢弃后继续重同步 垃圾帧+正常帧 → 仅 1 条正确读数 ✅
坏帧头 帧头错误的完整帧被丢弃 'Y'→'X' → 0 条读数 ✅

VM208（帧 CC F%05d T%03d E%05d S%c AA + 0D 0A，频率/10Hz、温度/10℃、电压/100V；激励帧 0F 0F 06 0A XX XX 0D 0A 大端）——Vm208FrameParserTest.kt（7 用例）+ Vm208CommandEncoder：

规格点 测试用例 断言要点 覆盖
正常帧解析 整帧解析出协议示例读数 CC F12345 T334 E14039 SG AA 0D 0A → 1234.5Hz / 33.4℃ / 140.39V / GOOD（原文档「14039/100=140V」为算术笔误，按公式断言） ✅
分片 分片喂入仍可切帧 半帧+半帧 → 1 条读数 ✅
质量字母映射 状态字母映射 Q 与 N SQ→FAIR、SN→NONE ✅
未知质量兜底 未知状态字母映射 UNKNOWN 而非崩溃 SX→UNKNOWN ✅
缺字段脏帧 缺字段脏帧被丢弃 CC F12345 AA 丢弃且后续帧正常 ✅
激励编码（大端） 激励命令编码与应答回解析 encodeExcitation(100) = 0F 0F 06 0A 00 64 0D 0A；应答回解析=100；截断帧→null ✅
激励越界防护 激励值越界抛出 0x10000 → IllegalArgumentException ✅

4.2 实测执行（./gradlew :ble-protocol:test）

  • 环境障碍与解决（如实记录）：本机无 JDK → Adoptium Temurin JDK 17.0.20.1 tarball 免 root 安装至 /tmp/jdk17；Gradle wrapper 默认 10s 连接超时下载失败 → curl 跟随重定向手动获取 gradle-8.10.2-bin.zip 解压至 /tmp/gradle-8.10.2 直跑 bin/gradle；dl.google.com 不可达无影响（工程仓库配置已优先阿里云镜像，见 settings.gradle.kts）。Gradle 用户目录与 JDK 均置于 /tmp，仓库零改动。
  • 命令：JAVA_HOME=/tmp/jdk17 GRADLE_USER_HOME=/tmp/gradle-home /tmp/gradle-8.10.2/bin/gradle :ble-protocol:test --configure-on-demand --no-daemon
  • 结果：BUILD SUCCESSFUL in 2m 13s，退出码 0；12/12 用例全部通过（IE-1000 5 用例 + VM208 7 用例，failures=0 errors=0 skipped=0，见 JUnit 结果 docs/e2e-evidence/protocol-test-results/TEST-*.xml 与 HTML 报告 html/index.html）：
com.stec.cmd.protocol.ie1000.Ie1000FrameParserTest: tests=5 failures=0 errors=0 skipped=0
   [PASS] 整帧一次喂入解析出协议示例读数
   [PASS] 逐字节分片喂入仍可切帧（残包容错）
   [PASS] 粘包两帧一次解析
   [PASS] 脏帧被丢弃后继续重同步
   [PASS] 帧头错误的完整帧被丢弃
com.stec.cmd.protocol.vm208.Vm208FrameParserTest: tests=7 failures=0 errors=0 skipped=0
   [PASS] 整帧解析出协议示例读数
   [PASS] 分片喂入仍可切帧
   [PASS] 状态字母映射 Q 与 N
   [PASS] 未知状态字母映射 UNKNOWN 而非崩溃
   [PASS] 缺字段脏帧被丢弃
   [PASS] 激励命令编码与应答回解析
   [PASS] 激励值越界抛出
  • 收尾：运行产生的构建产物已全部还原/清除（.gradle、ble-protocol/build 恢复至运行前状态——该仓库未忽略构建目录，产物不入交付提交），JUnit 结果已归档至 docs 证据目录。
  • 另：:app 模块自有单测 3 个（UploadPayloadWrapTest 3 用例、CollectPayloadBuilderTest 4 用例、StatsModelsTest）静态审阅覆盖上传体包装、采集读数→MonitorValue 组装（IE-1000 主值/VM208 频率主值+Extra 温度电压质量）、统计模型解析；因需 Android SDK 构建链，本轮未执行（同 §5 降级原因）。

5. UI 动线层（尽力而为）—— 静态走查推演

5.1 降级记录（如实留证）

实机路线在三个独立环节全部受阻，按任务书「失败≤2 次降级」口径提前降级：

  1. heart_android_preflight 连续 3 次调用返回 Premature close（MCP Android 服务通道异常）；heart_android_list_devices 30s 超时。
  2. 宿主无 Android SDK 且无法安装（local.properties 指向 Windows 路径且被 git 追踪不可改；自建 SDK 需 3–4GB 下载且 heart_android_install_app 通道同源异常，投入产出不成比例）。
  3. ./gradlew :app:assembleDebug 需 Android 构建链（AGP），无 SDK 无法产出 APK。

降级方式：全链路静态走查推演——逐页核对源码中的会话/配置/项目门控分支、跳转与状态机，证据以 file:line 标注。BLE 真机依赖项按任务书标注「模拟器不适用」。

5.2 动线走查表（逐页核对）

# 动线节点 静态核对证据（file:line） 推演结果
1 冷启动无「闪去登录」（Restoring 态） SessionRepository.kt:59 初始态 Restoring，init{restore()} 异步落定；MainActivity.kt:29 installSplashScreen()（Theme.SteCmd.Splash→Material3 主题切换）；MineFragment.kt:63-73 / ProjectWorkspaceFragment.kt:92 / TaskWorkspaceFragment.kt / CollectWorkspaceFragment.kt:136-139 / StatsWorkspaceFragment.kt:114 Restoring 均渲染中性加载、隐藏登录 CTA ✅ 五页一致无闪去登录
2 未配置引导（配置缺失警示卡） ConfigRepository.kt:49-50 isReady = baseUrl/secretKey/systemCode 非空；ProjectWorkspaceFragment.kt:95-96、TaskWorkspaceFragment.kt（stateConfig）、CollectWorkspaceFragment.kt:146-149（GateAction.CONFIG）、StatsWorkspaceFragment.kt:117-120、MineFragment.kt:102-106（警示卡常显 !isReady）——警示卡点击均 openOnTop(ConfigFragment) ✅ 全 Tab 门控一致
3 配置页录入假三要素 ConfigViewModel.kt:29-40 必填校验（「服务器地址、SecretKey、SystemCode 均为必填」）+ URL 前缀校验（http:// 或 https://）+ ConfigRepository.updateConnection 持久化（DataStore+加密，ConfigRepository.kt:94-96 trim 去尾斜杠） ✅ 校验与持久化闭环
4 登录负向错误提示 LoginViewModel.kt:99-117 表单校验→configReady() 门控（未配置提示「请先在『我的-服务器配置』填写…」）→ ApiError.userMessage()（ApiErrorMessages.kt:6-13，429「操作过于频繁」/403「连续失败次数过多」/网络/空体/服务器五类文案）；契约层实测的业务错误（如 用户名或密码错误！）经 ApiCaller 解包为带平台原文的 ApiError 展示 ✅ 负向链路文案闭环
5 登录页分段切换 LoginFragment.kt:45-73 MaterialButtonToggleGroup btn_mode_account/btn_mode_sms ↔ LoginMode.ACCOUNT/SMS，groupAccount/groupSms 互斥显隐；SMS 段含验证码 60s 倒计时（LoginViewModel.kt:126-134）与国内号全匹配校验（Phones.kt:16 ^1[3-9]\d{9}$） ✅ 双段切换+倒计时+校验
6 我的页身份卡/设置列表 MineFragment.kt:61-100 三态渲染：Restoring（中性）、SignedOut（游客卡=登录入口，改密置灰）、SignedIn（头像取姓名首字/姓名/部门/账号/手机号 + 退出登录）；设置行：改密/服务器配置 ✅
7 首页项目工作台（M2） ProjectWorkspaceFragment.kt:75-133 四态（Loading/Error(含重试)/Empty(空态刷新 CTA)/内容卡：项目名/编号/等级 Chip/阶段 Chip/项目计数）；M2-03 切换 ProjectSwitcherSheet（JSON 传参，onProjectPicked→HomeViewModel.select→ProjectSession） ✅
8 项目切换联动刷新（M2-03） ProjectSession.kt:34-40 登出自动清空；M3/M5/M6 三页均订阅 selectedProject 流（TaskWorkspaceFragment.kt:97、CollectWorkspaceFragment.kt:109、StatsWorkspaceFragment.kt:88），流变化触发整体重渲与数据刷新 ✅
9 任务页双列表/筛选/日期（M3） TaskWorkspaceFragment.kt:75-91 MY_TASKS/PLAN_TASKS 切换、状态 Chip 过滤（未开始/进行中/已完成）、日期 Chip+MaterialDatePicker、下拉刷新；未选项目空态 CTA→首页（btnGoHome） ✅
10 采集页门控与权限分版（M4-01） CollectWorkspaceFragment.kt:134-157 四级门控（Restoring/SignedOut/CONFIG/PROJECT）；BlePermissions.kt:24-31 API 31+ 分版 BLUETOOTH_SCAN/CONNECT（neverForLocation）vs 旧版 ACCESS_FINE_LOCATION，与 Manifest maxSdkVersion="30" 划线一致；拒绝态提供跳系统设置 ✅（真机权限行为「模拟器不适用」）
11 扫描/连接/采集会话（M4-02/03/07/08） CollectWorkspaceFragment.kt:171-253 扫描启停+空态、会话卡（选任务→选测点→开始/停止）、实时数据卡按设备类型切组（IE-1000 压力/温度；VM208 频率/温度/电压/质量）、VM208 激励卡（仅 GattState.Ready 可发）、自动重连开关（M4-09）、演示模式（FakeBleDriver）；本地队列 UploadQueueDao.enqueue（Room，M4-07 离线优先） ✅（BLE 实收「模拟器不适用」，FakeBleDriver 可演练）
12 测点列表/基准点/工点（M5-01/02/03） PointApi.kt 2.9/2.14/2.15 三端点接入；SurveyPointListFragment/ViewModel 测组→监测点列表；采集页上下文卡常驻（CollectWorkspaceFragment.kt:167-169） ✅
13 手动录入/补录（M5-04） ManualEntryViewModel.kt:39-123 表单编排+任务选择，uploadQueueDao.enqueue 与蓝牙采集同一队列（DATA_TYPE_MANUAL="手动录入"） ✅
14 统计页与上传（M6） StatsWorkspaceFragment.kt:22-60 队列状态卡（待传/成功/失败+手动重试）、SAF 原始文件上传（ActivityResultContracts.OpenDocument，免存储权限，M6-01→2.13）、计划统计表行点击下钻测组（2.11）→监测点（2.12）；UploadQueueSyncer.kt:38-46,91-107,178-204 启动触发+VALIDATED 网络恢复回调（onAvailable 防抖）+手动重试三通道补传，失败回退 PENDING 且 retry_count+1 留痕 ✅
15 5 Tab 全业务页（无占位） FeatureMount.kt:36-42 五 Tab 挂载 ProjectWorkspaceFragment/TaskWorkspaceFragment/CollectWorkspaceFragment/StatsWorkspaceFragment/MineFragment，PlaceholderFragment 未被挂载 ✅

推演局限：静态核对可证明「分支存在且互斥完整」，不能替代真机交互与 BLE 空中包验证；相关项在 §6 功能点清单中以「降级」口径计。

6. 功能点判定清单（本期 32 点）

判定口径：通过 = 代码实现+（实测或静态推演）证据完整；降级 = 实现完成但因环境限制未做实机/实机交互验证；缺口 = 功能缺失或行为不符。

模块 功能点 判定 依据（章节）
M1 M1-01 账号密码登录 通过 契约层 §3.2#1 + UI §5.2#4/5 + SessionRepository.kt:89
M1 M1-02 发送验证码（%2B86 转换） 通过 契约层 §3.2#2（B 组证实进入发送流程）+ Phones.kt:28-31
M1 M1-03 验证码登录（国内号全匹配） 通过 契约层 §3.2#3 + Phones.kt:16 + LoginViewModel.kt:94
M1 M1-04 修改登录密码 通过 契约层 §3.2#4 + SessionRepository.kt:108-113（成功后登出重登）
M1 M1-05 当前用户信息展示 通过 契约层 §3.2#5 + MineFragment.kt:85-98（含二次 JSON 编码宽容解析 SessionRepository.kt:146-156）
M1 M1-06 服务器与密钥配置管理 通过 UI §5.2#2/3 + ConfigRepository.kt（DataStore+加密、可随时换密钥不换包）
M1 M1-07 退出登录与 Token 清理 通过 SessionRepository.kt:116-119 + MineFragment.kt:51
M2 M2-01/M2-02 项目列表与信息展示 通过（降级*） 契约层 §3.2#6 + UI §5.2#7；列表内容渲染未实机截图
M2 M2-03 项目切换联动 通过（降级*） UI §5.2#8（ProjectSession 订阅链完整）
M3 M3-01 APP 端任务列表 通过（降级*） 契约层 §3.2#7 + UI §5.2#9
M3 M3-02 监测计划任务列表 通过（降级*） 契约层 §3.2#8 + UI §5.2#9
M3 M3-03 任务详情 通过（降级*） TaskDetailFragment.kt + TaskRepository.kt（2.6/2.7 data 归一）
M3 M3-04 状态流转展示 通过（降级*） TaskStatus 过滤 Chip + 列表渲染（TaskWorkspaceFragment.kt:82-91）
M3 M3-05 筛选与下拉刷新 通过（降级*） TaskWorkspaceFragment.kt:65-73,82-91
M4 M4-01 权限申请分版 通过（降级*） BlePermissions.kt（API 31 划线）+ Manifest 一致性
M4 M4-02 设备扫描（名称前缀过滤） 通过（降级*） BleScanner.kt + UI §5.2#11；真机扫描不适用模拟器
M4 M4-03 设备连接管理 通过（降级*） BleConnector.kt/SystemBleDriver.kt GATT 状态流；模拟器不适用
M4 M4-04 IE-1000 解析 通过 协议层 §4（静态矩阵+单测实测）——协议本体已实测，实机 Notify 通道不适用
M4 M4-05 VM208 解析 通过 同上 §4
M4 M4-06 VM208 激励下发 通过（协议）/ 降级（BLE 通道） §4 编码实测 + CollectWorkspaceFragment.kt:250-253
M4 M4-07 本地暂存队列（Room） 通过（降级*） UploadQueueSyncer.kt 状态机 + UploadQueueEntity；:app 单测静态审阅
M4 M4-08 采集会话管理 通过（降级*） UI §5.2#11（Idle/Preparing/Running 状态机）
M4 M4-09 断连与自动重连 通过（降级*） autoReconnect 开关 + 重连策略；真机断连不适用模拟器
M5 M5-01 测组监测点列表 通过（降级*） 契约层 §3.2#9 + SurveyPointListFragment
M5 M5-02 基准点获取 通过（降级*） 契约层 §3.2#14（含 2.14 服务端特例记录 §3.4）
M5 M5-03 工点数据 通过（降级*） 契约层 §3.2#15 + PointApi.PATH_GET_WORK_POINT
M5 M5-04 手动录入/补录 通过（降级*） ManualEntryViewModel.kt:107-123 同队列入队
M6 M6-01 原始文件上传（2.13） 通过（降级*） 契约层 §3.2#13（multipart 形状实测）+ SAF 选择器 + :app UploadPayloadWrapTest
M6 M6-02 计划统计表 通过（降级*） 契约层 §3.2#10 + StatsPlanListAdapter 下钻链
M6 M6-03 测组统计表 通过（降级*） 契约层 §3.2#11 + SurveyGroupStatsFragment
M6 M6-04 监测点统计表 通过（降级*） 契约层 §3.2#12 + PointStatsFragment
M7* M7-01~04 基础工程层（附带核查） 通过 AuthInterceptor/ApiEnvelope/ApiCaller（三要素+四码统一解析）、Room 队列、ble-protocol 独立 JVM 模块（单测实测跑通）、密钥文件不入库（docs 引用）

* 「降级」含义：静态走查推演通过但未做实机交互验证（§5.1 降级口径），非功能缺陷。标注「通过」且无星号者，其核心证据为实测（契约层真实请求 / 协议层单测实跑）。

汇总：32 点全部无缺口；其中实测通过 10 点（契约层 7 点直接承载 + 协议层 3 点），静态推演通过 22 点（降级口径）。

7. 正向链路遗留项与移交建议

遗留（阻塞：无真实测试凭据，本次未做正向链路端到端实测）：

  1. 真实凭据登录 → 2.4 用户信息 → 2.5.1.1 项目列表 → 2.6/2.7 任务 → 2.9/2.14/2.15 测点上下文 → 2.13 上传 → 2.10/2.11/2.12 统计的正向全链路实测（需院方下发测试账号；或由有账号同事在真机回归）。
  2. 2.2.2 验证码真实下发（本次沙箱实测腾讯云 SMS 出网失败，测试服务器自身出网能力需在真实网络环境复核）。
  3. 429/403 负向边界（一分钟频控阈值、连续报错锁定与解锁窗口——待确认问题 #3，需平台方确认规则后专项触发）。
  4. Token 失效场景实测（长 Token 过期后 2.4 应返回失败并按「重新登录」处理——SessionRepository.kt:79-85 已实现该缺省口径，待真实验证）。
  5. 真机 BLE 空中包回归（IE-1000/VM208 真实设备 Notify/Write 与断连重连）。
  6. 服务端反馈项：§3.4 的 2.14 ControlPoint 鉴权包装不一致；§3.5 的 2.8.2 死代码常量清理（客户端自查项）。

移交建议：①向院方申请测试账号与验证码通道白名单，补做 §7.1/7.2 正向链路与 429 边界；②将 docs/e2e-evidence/contract_probe.py 纳入例行回归（真实凭据就绪后可扩展正向断言）；③UI 层在 CI/真机资源具备时按 §5.2 表逐项补实机截图验收。

8. 证据文件索引

证据 路径
契约层探测脚本 docs/e2e-evidence/contract_probe.py
契约层机器可读结果 docs/e2e-evidence/contract_results.json
契约层证据汇总表（自动生成） docs/e2e-evidence/contract_evidence.md
原始响应存档（30 份，密钥脱敏） docs/e2e-evidence/responses/A_*.txt、B_*.txt
协议层测试源码（静态审阅对象） ble-protocol/src/test/kotlin/com/stec/cmd/protocol/**
协议层实测 JUnit 结果（XML + HTML） docs/e2e-evidence/protocol-test-results/（含 TEST-*.xml、html/index.html）
契约依据解析全文 docs/e2e-evidence/api_doc_V4.5_extracted.txt（自 docx 原件解析：docs/上海城建勘测院监测数据不落地系统接口文档V4.5.docx）
首次连通性探测（curl 手工样例） docs/e2e-evidence/responses/manual_curl_GetUserInfo_nohdr.txt
Reference in New Issue View Git Blame Copy Permalink