KennethCheng
df5db7bc36
Phase 1.3a。Phase 1.2 留的 repo 现在有了真正的业务出口,Phase 1.3b 紧接
handler / router 把 HTTP 接进来,业务就能跑通。
新增:
- pkg/decimal/money.go
* PricePerLiter(total, liters) 服务端实时算实际油价,落库
* ConsumptionL100km(l, mileage) 百公里油耗,只用于 is_full 序列
* CostPerKm(amount, mileage) 每公里成本
* Mileage(cur, prev) 行驶里程,负数 / 零视为无效
* AvgFloat64(xs) 求平均,空切片返回 0
全部走 shopspring/decimal,避免 float64 累计误差
- internal/dto/dto.go
* VehicleCreate / VehicleUpdate (patch 语义,*T 表示可选)
* RefuelCreate / RefuelUpdate
入参校验走 gin-validator 的 tag:required / gte / gt / max
(Liters > 0、TotalAmount >= 0、Odometer >= 0 与 plan §16 一致)
- internal/service/vehicle.go
* Create 时若 default_vehicle=true,事务内先 ClearDefault 再 Insert,
避免出现两个默认车辆
* Update 同样事务化 default 切换
* SetDefault 是显式接口,业务上"切默认车"是常用操作
全部错误用 apperror 包成 NotFound / InvalidArg / Internal
- internal/service/refuel_record.go
* Create:校验车辆存在 + Liters > 0 + TotalAmount >= 0,服务端
实时计算 price_per_liter,RefuelTime 统一转 UTC 存库
* Update:patch 语义,liters / total_amount 任一变更都重新算
price_per_liter(否则历史单价会失真)
* Statistics(单车):返回 累计次数 / 累计升数 / 累计金额 / 平均油价 /
标准百公里油耗 / 每公里成本 / 最近一次加油
关键实现:仅在"连续两次 is_full=true"之间采油耗样本,
半箱油 / 部分加油记录不会污染标准油耗 ——
这条规则直接来自 plan §6.3 与 §19 验收要求
业务规则(AGENTS.md 强约束):
车辆名称 / 能源类型 不允许为空(trim 后空字符串也拒)
加油量 > 0、总金额 >= 0、里程 >= 0 都在 service 入参立即校验
RefuelTime 统一 UTC 存库,展示按本地时区格式化
默认车辆唯一,切换走事务,杜绝"两个默认"
未做(留给 Phase 1.3b 下一个 commit):
- HTTP handler / router / main 装配
- 单元测试(本文件不含测试,等所有 service 稳定后单独提一个测试 commit)
- Dashboard / 统计 API(基础 Statistics 已就绪,Dashboard endpoint
留给 Phase 1.3b 末尾)
验证:
go mod tidy all modules verified
go vet ./... 0 issues
go build 25.9 MB binary
62 lines
2.6 KiB
Go
62 lines
2.6 KiB
Go
// Package dto 持有 HTTP 入参与返回 DTO。
|
|
//
|
|
// 与 model 的区别:
|
|
// - model 反映数据库一行;DTO 反映一次 HTTP 请求/响应
|
|
// - DTO 字段做基础校验(必填 / 范围)
|
|
// - 字段命名贴近用户语言(中文含义在 JSON tag 上保持英文)
|
|
package dto
|
|
|
|
import "time"
|
|
|
|
// VehicleCreate 新建车辆请求。
|
|
type VehicleCreate struct {
|
|
Name string `json:"name" binding:"required,max=64"`
|
|
Brand string `json:"brand" binding:"max=64"`
|
|
Model string `json:"model" binding:"max=64"`
|
|
PlateNumber string `json:"plate_number" binding:"max=32"`
|
|
FuelType string `json:"fuel_type" binding:"required,max=32"`
|
|
TankCapacity float64 `json:"tank_capacity" binding:"gte=0,lte=9999"`
|
|
CurrentOdometer float64 `json:"current_odometer" binding:"gte=0"`
|
|
DefaultVehicle bool `json:"default_vehicle"`
|
|
}
|
|
|
|
// VehicleUpdate 更新车辆请求。所有字段可选(零值表示"不改")。
|
|
// 这里采用 patch 语义:仅传了的字段会被更新。
|
|
type VehicleUpdate struct {
|
|
Name *string `json:"name"`
|
|
Brand *string `json:"brand"`
|
|
Model *string `json:"model"`
|
|
PlateNumber *string `json:"plate_number"`
|
|
FuelType *string `json:"fuel_type"`
|
|
TankCapacity *float64 `json:"tank_capacity"`
|
|
CurrentOdometer *float64 `json:"current_odometer"`
|
|
DefaultVehicle *bool `json:"default_vehicle"`
|
|
}
|
|
|
|
// RefuelCreate 新建加油记录请求。
|
|
// 实际油价(price_per_liter)由服务端实时计算,不入参。
|
|
type RefuelCreate struct {
|
|
VehicleID uint64 `json:"vehicle_id" binding:"required"`
|
|
RefuelTime time.Time `json:"refuel_time" binding:"required"`
|
|
Odometer float64 `json:"odometer" binding:"required,gte=0"`
|
|
FuelType string `json:"fuel_type" binding:"required,max=32"`
|
|
Liters float64 `json:"liters" binding:"required,gt=0"`
|
|
TotalAmount float64 `json:"total_amount" binding:"gte=0"`
|
|
StationName string `json:"station_name" binding:"max=128"`
|
|
IsFull bool `json:"is_full"`
|
|
Remark string `json:"remark" binding:"max=512"`
|
|
}
|
|
|
|
// RefuelUpdate 更新加油记录请求。
|
|
// 同 VehicleUpdate,patch 语义;Liters / TotalAmount 任一变化都触发 price 重新计算。
|
|
type RefuelUpdate struct {
|
|
RefuelTime *time.Time `json:"refuel_time"`
|
|
Odometer *float64 `json:"odometer"`
|
|
FuelType *string `json:"fuel_type"`
|
|
Liters *float64 `json:"liters"`
|
|
TotalAmount *float64 `json:"total_amount"`
|
|
StationName *string `json:"station_name"`
|
|
IsFull *bool `json:"is_full"`
|
|
Remark *string `json:"remark"`
|
|
}
|