docs/客户详情运营统计暂缓记录.md

客户详情运营统计暂缓记录

当前决定

客户详情顶部以下三项运营统计暂不展示：

• 累计运单；
• 累计应收；
• 在途柜量。

Admin 页面只隐藏展示并停止发起对应统计请求；Order、Finance、Firstleg 已有只读统计接口保留，不删除后端事实能力。客户详情“业务概况”页签中的趋势、分布、目的港和收入分析也暂不继续开发，不使用模拟数据替代。

在途柜量问题记录

测试环境样本的只读联查确认：客户、订舱、柜次和装柜明细归属正确，但柜次仅有预计开船时间，actual_sailing_at 为空，因此按“已实际开船且尚未实际到仓”的在途定义统计为 0。

装柜完成、国内出仓和订舱放舱均不等于实际开船，不应自动推断或回填 actual_sailing_at。当前货柜履约链缺少装柜完成后的“确认实际开船”正式入口；如后续恢复在途统计展示，应先由货柜履约域补齐实际开船事实生产、权限、幂等、乐观锁和运输时间线，再由客户统计消费该字段。