feat(pl): 加油汇总顶部改为近10/20/30次平均油耗。

按相邻登记的升数与期初公里差计算 L/100km,并恢复汇总页车牌卡片展示。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
wuzilongandCursor committed 2026-11-19 18:00:00 +08:00
1 parent 90fc25f3fe
commit c658f78329
12 files changed
+352 -276

No files matched your search

@@ -0,0 +1,3 @@
schema: spec-driven
created: 2026-11-19
issue: 48
@@ -0,0 +1,14 @@
## Context
汇总页与本人登记页共用 `FuelRegisterListPage`;仅 `mode=summary` 显示顶部卡片。原月度指标 API 仍保留字段,前端改为展示近 N 次平均。
## Decision
1. **计算放后端**:租户隔离、数据范围与作废过滤与列表一致;前端只展示。
2. **复用 `plate-month-summary`**:增加 `avgRateLast10/20/30L100`,拉取该车全部正常未删登记再切片,避免新路由。
3. **单位 L/100km**:与既有 `rate_l100` 一致;升数≤0 或里程差≤0 的段不计入平均。
4. **UI**:去掉月份条;三项指标;点击车牌仍写列头车牌过滤。
## Risks
- 全量历史登记加载:自有车加油量通常可控;若日后变大再按车牌限窗。
@@ -0,0 +1,26 @@
## Why
加油登记汇总页顶部曾改为「待开发」。业务需要按车牌展示近 10/20/30 次平均油耗(L/100km),替代原按月加油量/里程/月季油耗卡片内容。
## What Changes
- 恢复汇总页顶部车牌卡片(复用既有卡片布局,去掉月份选择)
- `plate-month-summary` 增加近 10/20/30 次平均百公里油耗字段
- 单次油耗:`(上次加油升数 × 100) / (本次期初公里 − 上次期初公里)`
- 近 N 次:同一车牌时间升序中,最近 N 个有效单次的算术平均;无效段跳过
## Capabilities
### New Capabilities
- (无)
### Modified Capabilities
- `pl-vehicle-fuel-summary`: 汇总顶部统计口径改为近 N 次平均 L/100km
## Impact
- 后端 `pl_vehicle_fuel_service` / `vehicle_fuel` schema
- Web `FuelPlateMonthCards`、`FuelRegisterListPage`、API 类型
- 工单:https://gitea.aichengyan.com/cykj/shanxia2.0/issues/48
@@ -0,0 +1,25 @@
## ADDED Requirements
### Requirement: 近 N 次平均百公里油耗
系统 SHALL 在加油登记汇总顶部按自有车牌展示近 10、20、30 次平均油耗,单位为 L/100km。
#### Scenario: 单次油耗计算
- **WHEN** 同一车牌存在相邻两次正常未删除登记,且上次加油升数 > 0、本次期初公里 > 上次期初公里
- **THEN** 该段油耗为 `上次加油升数 × 100 / (本次期初公里 − 上次期初公里)`,保留两位小数
#### Scenario: 近 N 次平均
- **WHEN** 某车牌存在至少一段有效单次油耗
- **THEN** 近 N 次平均为时间升序下最近 min(N, 有效段数) 个单次油耗的算术平均;无效段(缺期初、升数≤0、里程未增加)不计入
#### Scenario: 数据不足
- **WHEN** 某车牌没有有效单次油耗段
- **THEN** 对应近 N 次平均字段为 null,界面显示 —
#### Scenario: 点击筛选
- **WHEN** 用户点击某车牌卡片
- **THEN** 下方列表按该车牌过滤;再次点击同一车牌取消过滤
@@ -0,0 +1,15 @@
## 1. 后端
- [x] 单次/近 N 次平均算法与单测
- [x] schema 增加 avgRateLast10/20/30L100
- [x] `list_plate_month_summary` 填充新字段;汇总回归断言
## 2. Web
- [x] 恢复汇总顶部卡片,展示近 10/20/30 次平均
- [x] API 类型字段对齐
## 3. 验证
- [x] `pytest` 加油汇总相关:21 passed
- [ ] 本机打开汇总页目视验收(需在任务 worktree 启前后端)