41 lines
3.2 KiB
Markdown
41 lines
3.2 KiB
Markdown
|
# 开发日志：配送详情与隐私化轨迹
|
|||
|
|
|
|||
|
|
操作时间：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均记为“部分实现”。
|