a976bf525a
- Update Android client architecture documentation - Update Android client feature specification - Update Android client development plan - Refresh file index metadata
134 lines
7.2 KiB
Markdown
134 lines
7.2 KiB
Markdown
# 安卓客户端功能明细表
|
||
|
||
> 2026-09-03 重建版：原文档随工作树清理丢失，按任务记录与接口解析稿（V4.5）复刻。接口清单以解析稿为准（15 个在用 + 2 个废除子接口）。
|
||
|
||
## 文档属性
|
||
|
||
| 属性 | 值 |
|
||
|---|---|
|
||
| 项目 | 上海城建勘测院 · 监测数据不落地平台安卓客户端 |
|
||
| 依据 | 接口管理规范 V4.5、BLE-IE1000/VM208 蓝牙协议说明 |
|
||
| 优先级定义 | P0=应用可发布的最小闭环；P1=重要；P2=增强 |
|
||
| 功能点合计 | 36（P0×23 / P1×11 / P2×2） |
|
||
|
||
## 模块总览
|
||
|
||
| 模块 | 名称 | 功能点数 | P0 | P1 | P2 |
|
||
|---|---|---|---|---|---|
|
||
| M1 | 我的（登录与配置） | 7 | 5 | 1 | 1 |
|
||
| M2 | 首页（项目工作台） | 3 | 2 | 1 | 0 |
|
||
| M3 | 任务管理 | 5 | 3 | 2 | 0 |
|
||
| M4 | 采集·蓝牙 | 9 | 7 | 2 | 0 |
|
||
| M5 | 采集·测点数据 | 4 | 0 | 3 | 1 |
|
||
| M6 | 统计与数据上传 | 4 | 2 | 2 | 0 |
|
||
| M7 | 基础工程层 | 4 | 4 | 0 | 0 |
|
||
| 合计 | | 36 | 23 | 11 | 2 |
|
||
|
||
## M1 我的（登录与配置）
|
||
|
||
| 编号 | 功能点 | 对应 API | 优先级 | 说明 |
|
||
|---|---|---|---|---|
|
||
| M1-01 | 账号密码登录 | 2.2.1 | P0 | 请求头带 SecretKey/SystemCode，成功取得 Token |
|
||
| M1-02 | 获取短信验证码 | 2.2.2 | P0 | 手机号 +86 需转 %2B86 |
|
||
| M1-03 | 验证码登录 | 2.2.3 | P0 | 国内手机号全匹配校验 |
|
||
| M1-04 | 修改登录密码 | 2.3.1 | P1 | 登录态下操作 |
|
||
| M1-05 | 当前用户信息展示 | 2.4 | P0 | 头像/姓名/角色等 |
|
||
| M1-06 | 服务器与密钥配置管理 | 无（本地） | P0 | baseUrl/SecretKey/SystemCode/Token 持久化（DataStore+加密），M7-04 落地入口 |
|
||
| M1-07 | 退出登录与 Token 清理 | 无（本地） | P2 | 清除本地 Token 与缓存 |
|
||
|
||
## M2 首页（项目工作台）
|
||
|
||
| 编号 | 功能点 | 对应 API | 优先级 | 说明 |
|
||
|---|---|---|---|---|
|
||
| M2-01 | 当前用户项目列表 | 2.5.1.1 | P0 | 外业人员可参与多项目 |
|
||
| M2-02 | 项目基本信息展示 | 2.5.1.1（data） | P0 | 项目名称/编号/状态 |
|
||
| M2-03 | 项目切换 | 2.5.1.1（本地选中态） | P1 | 切换后任务/统计跟随刷新 |
|
||
|
||
## M3 任务管理
|
||
|
||
| 编号 | 功能点 | 对应 API | 优先级 | 说明 |
|
||
|---|---|---|---|---|
|
||
| M3-01 | APP 端任务列表 | 2.6 | P0 | 外业人员当日/近期任务 |
|
||
| M3-02 | 项目监测计划任务列表 | 2.7 | P0 | 按监测计划组织 |
|
||
| M3-03 | 任务详情 | 2.6/2.7（data） | P0 | 测组、测点、计划周期等 |
|
||
| M3-04 | 任务状态流转展示 | 2.6/2.7（data） | P1 | 未开始/进行中/已完成 |
|
||
| M3-05 | 任务筛选与下拉刷新 | 2.6/2.7 | P1 | 按状态/时间过滤 |
|
||
|
||
## M4 采集·蓝牙
|
||
|
||
| 编号 | 功能点 | 对应 API | 优先级 | 说明 |
|
||
|---|---|---|---|---|
|
||
| M4-01 | 蓝牙与定位权限申请 | 无（系统） | P0 | Android 12L 分版（BLUETOOTH_SCAN/CONNECT vs 旧版+定位） |
|
||
| M4-02 | 设备扫描 | 无（BLE） | P0 | 按名称前缀过滤：IE-1000、VM208 |
|
||
| M4-03 | 设备连接管理 | 无（BLE GATT） | P0 | 两设备各有服务/写/Notify UUID；连接状态流 |
|
||
| M4-04 | IE-1000 数据接收解析 | 无（BLE Notify） | P0 | 帧 `'Y'+4B float+'T'+4B float+0D 0A`（压力/温度） |
|
||
| M4-05 | VM208 数据接收解析 | 无（BLE Notify） | P0 | 帧 `CC F%05d T%03d E%05d S%c AA+0D 0A`；频率/10Hz、温度/10℃、电压/100V |
|
||
| M4-06 | VM208 激励命令下发 | 无（BLE Write） | P0 | `0F 0F 06 0A XX XX 0D 0A`，XX XX 大端 16 位 |
|
||
| M4-07 | 采集数据本地暂存 | 无（Room） | P0 | 先落本地队列，网络可用后上传（离线优先） |
|
||
| M4-08 | 采集会话管理 | 无（本地） | P1 | 开始/停止采集、绑定任务与测点 |
|
||
| M4-09 | 断连与异常处理 | 无（BLE） | P1 | 断连提示、自动重连策略 |
|
||
|
||
## M5 采集·测点数据
|
||
|
||
| 编号 | 功能点 | 对应 API | 优先级 | 说明 |
|
||
|---|---|---|---|---|
|
||
| M5-01 | 测组监测点列表 | 2.9 | P1 | 按测组拉取监测点 |
|
||
| M5-02 | 基准点获取 | 2.14 | P1 | 水平位移等计算的基准 |
|
||
| M5-03 | 工点数据 | 2.15 | P1 | 工点/测项结构（目录页 2.15 笔误 ControlPoint，以正文为准） |
|
||
| M5-04 | 手动录入/补录 | 2.13（配合） | P2 | 无法蓝牙采集时人工录入后走同一上传队列 |
|
||
|
||
## M6 统计与数据上传
|
||
|
||
| 编号 | 功能点 | 对应 API | 优先级 | 说明 |
|
||
|---|---|---|---|---|
|
||
| M6-01 | 原始文件上传与解析 | 2.13 | P0 | 数据解析（原始文件上传），采集文件的兜底通道 |
|
||
| M6-02 | 项目监测计划统计表 | 2.10 | P0 | 项目维度完成度 |
|
||
| M6-03 | 测组统计表 | 2.11 | P1 | 指定监测计划的测组统计 |
|
||
| M6-04 | 监测点统计表 | 2.12 | P1 | 测点维度历史数据 |
|
||
|
||
## M7 基础工程层
|
||
|
||
| 编号 | 功能点 | 对应 API | 优先级 | 说明 |
|
||
|---|---|---|---|---|
|
||
| M7-01 | 网络框架 | 全部 | P0 | 鉴权三要素拦截器 + 200/500/429/403 统一解析（core:network） |
|
||
| M7-02 | 本地存储框架 | 无 | P0 | Room 队列 + 加密配置存储（core:database + DataStore） |
|
||
| M7-03 | 协议解析独立模块 | 无 | P0 | 纯 Kotlin JVM，脱离真机可单测（ble-protocol） |
|
||
| M7-04 | 密钥配置管理 | 无 | P0 | SecretKey/SystemCode 不进代码库，可随时更换（.gitignore + ConfigRepository） |
|
||
|
||
## 第 3 节 待确认问题（8 项）
|
||
|
||
| # | 问题 | 缺省处理 |
|
||
|---|---|---|
|
||
| 1 | SecretKey/SystemCode 的分发与更换流程 | 做成配置项，支持不换包更换 |
|
||
| 2 | Token 有效期与刷新机制 | 无刷新接口，过期按 401/500 重新登录 |
|
||
| 3 | 429/403 的解锁规则与窗口 | 按接口文档语义提示用户稍后重试 |
|
||
| 4 | 任务状态是否允许 APP 端上报变更 | S0 只读展示，不上报 |
|
||
| 5 | 2.13 原始文件上传的文件格式与大小限制 | 按采集仪原始文件直传 |
|
||
| 6 | 监测值上传是否走 2.8（已废除）替代接口 | 以 2.13 + 待定接口为准，待院方确认 |
|
||
| 7 | 蓝牙后台采集是否需要 | 默认前台采集 |
|
||
| 8 | 多项目并行采集的合并口径 | 单项目单会话 |
|
||
|
||
## 附录 A 接口覆盖对照
|
||
|
||
| 章节 | 接口名称 | 状态 | 承载模块 |
|
||
|---|---|---|---|
|
||
| 2.2.1 | 账号密码登录 | 在用 | M1-01 |
|
||
| 2.2.2 | 发送验证码 | 在用 | M1-02 |
|
||
| 2.2.3 | 手机验证码登录 | 在用 | M1-03 |
|
||
| 2.3.1 | 修改登录密码 | 在用 | M1-04 |
|
||
| 2.4 | 获取当前用户信息 | 在用 | M1-05 |
|
||
| 2.5.1.1 | 获取当前用户项目列表 | 在用 | M2-01/02/03 |
|
||
| 2.6 | 获取 APP 端任务列表 | 在用 | M3-01/03/04/05 |
|
||
| 2.7 | 获取项目监测计划任务列表 | 在用 | M3-02/03/04/05 |
|
||
| 2.8.1 | 获取监测计划 | 废除 | 不实现 |
|
||
| 2.8.2 | 上传本次监测值 | 废除 | 不实现（上传通道待院方确认，见待确认 #6） |
|
||
| 2.9 | 获取测组包含的监测点列表 | 在用 | M5-01 |
|
||
| 2.10 | 获取项目监测计划统计表 | 在用 | M6-02 |
|
||
| 2.11 | 获取指定监测计划的测组统计表 | 在用 | M6-03 |
|
||
| 2.12 | 监测点统计表 | 在用 | M6-04 |
|
||
| 2.13 | 数据解析（原始文件上传） | 在用 | M6-01、M5-04 |
|
||
| 2.14 | 获取基准点 | 在用 | M5-02 |
|
||
| 2.15 | 获取工点数据 | 在用 | M5-03 |
|
||
|
||
> 返回状态值约定（接口文档 1.1）：200 成功；500 失败；429 同一条数据一分钟内频繁请求超限；403 同一条数据连续报错超限。
|