3.2 KiB
3.2 KiB
开发日志:配送详情与隐私化轨迹
操作时间:2026-09-12 00:05(Asia/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.dart、delivery_track.dart:严格解析服务端事实。apps/user_app/lib/ui/features/orders/delivery_detail_page.dart、delivery_track_page.dart:图22和图23页面。apps/user_app/lib/app/router.dart、client_repository.dart:路由和仓储接入。apps/user_app/assets/staff/delivery-worker.png、assets/design/delivery-route-map.png:视觉夹具人员图和无文字地图底图。
验证结果
- Go:
go test ./internal/logic/client/user ./internal/routers、go vet ./...、go build通过。 - Flutter:
flutter analyze、配送详情/轨迹组件测试、图23八组视觉测试和Web Release构建通过。 - 真实只读联调:远程样例订单返回“已完成”、王师傅、脱敏电话、1个隐私化位置点和1个履约节点;未创建或修改订单、资金、轨迹及人员资料。
- 内置浏览器:从图22页面点击“查看实时轨迹”进入图23,地图、状态、时间线、人员和底部按钮均可见;刷新可重新读取数据;电话入口显示“电话联系暂未开放”。
风险评估
- 远程样例订单只有一个轨迹点,真实页不能形成完整道路折线;Fixture仅用于同状态视觉对照,不能替代真实多点联调。
- 当前地图是无地名的本地背景,路线表达为隐私化坐标的相对进度,不声称提供精确导航。
- 配送车辆、头像资源代理、受控呼叫/消息和配送异常上报仍是首期待办,因此图22和图23均记为“部分实现”。