Files
platforms/docs/开发日志_配送详情与隐私化轨迹_20260912.md
czl231 3ef33b531d 已完成用户APP首期功能开发
交付用户端首期页面、配套接口、后台资源及测试文档。用户APP构建、静态分析和三个管理后台构建通过;完整测试仍有2项失败,后端模型注释检查未通过,详见交付记录。
2026-09-13 00:57:32 +08:00

3.2 KiB
Raw Permalink Blame History

开发日志:配送详情与隐私化轨迹

操作时间2026-09-12 00:05Asia/Shanghai
操作类型:新增、扩展
影响模块:用户端 App、Client API、视觉验收

操作前状态

图22和图23没有独立用户页面。订单详情的“查看配送”只能进入未开放提示用户端也没有本人订单的配送人员、有效资质或简化轨迹接口。

具体操作

  • 新增本人供气订单配送详情接口,读取订单、气站、配送点、当前配送员、有效资质、最新轨迹摘要和商品;不下发员工内部账号或明文手机号。
  • 新增本人供气订单配送轨迹接口复用配送端已经上报的不可变轨迹点和订单状态历史。经纬度约化到三位小数后下发最多返回最近一次配送尝试的200个顺序点。
  • 新增图22配送详情页和图23配送轨迹页并将订单详情、配送详情、配送轨迹三页串联。轨迹页支持真实刷新地图背景为项目本地位图蓝色路线只根据服务端隐私化坐标绘制。
  • 车辆后台资料、受控电话、订单消息和配送问题上报目前没有完整服务,入口保留并明确显示“暂未开放”。这些是首期缺项,没有标为二期。
  • 增加图22、图23的390×844对照图及320、360、390、430四种宽度和1.0、1.3两种文字倍率截图。

代码变更

  • backend/api/internal/logic/client/user/delivery_detail.go:本人配送详情聚合与能力状态。
  • backend/api/internal/logic/client/user/delivery_track.go:本人轨迹、坐标约化和履约节点。
  • backend/api/internal/routers/client.go:新增配送详情及轨迹只读路由。
  • apps/user_app/lib/domain/models/delivery_detail.dartdelivery_track.dart:严格解析服务端事实。
  • apps/user_app/lib/ui/features/orders/delivery_detail_page.dartdelivery_track_page.dart图22和图23页面。
  • apps/user_app/lib/app/router.dartclient_repository.dart:路由和仓储接入。
  • apps/user_app/assets/staff/delivery-worker.pngassets/design/delivery-route-map.png:视觉夹具人员图和无文字地图底图。

验证结果

  • Gogo test ./internal/logic/client/user ./internal/routersgo vet ./...go build通过。
  • Flutterflutter analyze、配送详情/轨迹组件测试、图23八组视觉测试和Web Release构建通过。
  • 真实只读联调远程样例订单返回“已完成”、王师傅、脱敏电话、1个隐私化位置点和1个履约节点未创建或修改订单、资金、轨迹及人员资料。
  • 内置浏览器从图22页面点击“查看实时轨迹”进入图23地图、状态、时间线、人员和底部按钮均可见刷新可重新读取数据电话入口显示“电话联系暂未开放”。

风险评估

  • 远程样例订单只有一个轨迹点真实页不能形成完整道路折线Fixture仅用于同状态视觉对照不能替代真实多点联调。
  • 当前地图是无地名的本地背景,路线表达为隐私化坐标的相对进度,不声称提供精确导航。
  • 配送车辆、头像资源代理、受控呼叫/消息和配送异常上报仍是首期待办因此图22和图23均记为“部分实现”。