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
172 lines
4.8 KiB
Go
172 lines
4.8 KiB
Go
// Package service 持有业务逻辑,只依赖 repository 接口,不直接碰 GORM。
|
|
//
|
|
// 计算类逻辑(如油价/油耗/成本)放这里,不放在 handler,便于单测。
|
|
package service
|
|
|
|
import (
|
|
"context"
|
|
"strings"
|
|
|
|
"gorm.io/gorm"
|
|
|
|
"github.com/kennethcheng/fuellog-api/internal/dto"
|
|
"github.com/kennethcheng/fuellog-api/internal/model"
|
|
"github.com/kennethcheng/fuellog-api/internal/repository"
|
|
"github.com/kennethcheng/fuellog-api/pkg/apperror"
|
|
)
|
|
|
|
// VehicleService 车辆业务逻辑。
|
|
type VehicleService interface {
|
|
Create(ctx context.Context, in *dto.VehicleCreate) (*model.Vehicle, error)
|
|
Get(ctx context.Context, id uint64) (*model.Vehicle, error)
|
|
List(ctx context.Context) ([]model.Vehicle, error)
|
|
Update(ctx context.Context, id uint64, in *dto.VehicleUpdate) (*model.Vehicle, error)
|
|
Delete(ctx context.Context, id uint64) error
|
|
SetDefault(ctx context.Context, id uint64) (*model.Vehicle, error)
|
|
}
|
|
|
|
func NewVehicleService(repo repository.VehicleRepository, db *gorm.DB) VehicleService {
|
|
return &vehicleService{repo: repo, db: db}
|
|
}
|
|
|
|
type vehicleService struct {
|
|
repo repository.VehicleRepository
|
|
db *gorm.DB
|
|
}
|
|
|
|
func (s *vehicleService) Create(ctx context.Context, in *dto.VehicleCreate) (*model.Vehicle, error) {
|
|
v := &model.Vehicle{
|
|
Name: strings.TrimSpace(in.Name),
|
|
Brand: strings.TrimSpace(in.Brand),
|
|
Model: strings.TrimSpace(in.Model),
|
|
PlateNumber: strings.TrimSpace(in.PlateNumber),
|
|
FuelType: strings.TrimSpace(in.FuelType),
|
|
TankCapacity: in.TankCapacity,
|
|
CurrentOdometer: in.CurrentOdometer,
|
|
DefaultVehicle: in.DefaultVehicle,
|
|
}
|
|
if v.Name == "" {
|
|
return nil, apperror.New(apperror.CodeInvalidArg, "车辆名称不能为空")
|
|
}
|
|
if v.FuelType == "" {
|
|
return nil, apperror.New(apperror.CodeInvalidArg, "能源类型不能为空")
|
|
}
|
|
|
|
// 任何显式设为默认的车辆,都要先清掉其它默认(在事务里完成)
|
|
if v.DefaultVehicle {
|
|
err := s.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
|
|
if err := s.repo.ClearDefault(ctx, tx); err != nil {
|
|
return err
|
|
}
|
|
if err := tx.WithContext(ctx).Create(v).Error; err != nil {
|
|
return apperror.Wrap(apperror.CodeInternal, "创建车辆失败", err)
|
|
}
|
|
return nil
|
|
})
|
|
if err != nil {
|
|
if appErr, ok := apperror.As(err); ok {
|
|
return nil, appErr
|
|
}
|
|
return nil, err
|
|
}
|
|
return v, nil
|
|
}
|
|
|
|
if err := s.repo.Create(ctx, v); err != nil {
|
|
return nil, err
|
|
}
|
|
return v, nil
|
|
}
|
|
|
|
func (s *vehicleService) Get(ctx context.Context, id uint64) (*model.Vehicle, error) {
|
|
return s.repo.Get(ctx, id)
|
|
}
|
|
|
|
func (s *vehicleService) List(ctx context.Context) ([]model.Vehicle, error) {
|
|
return s.repo.List(ctx)
|
|
}
|
|
|
|
func (s *vehicleService) Update(ctx context.Context, id uint64, in *dto.VehicleUpdate) (*model.Vehicle, error) {
|
|
v, err := s.repo.Get(ctx, id)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
if in.Name != nil {
|
|
v.Name = strings.TrimSpace(*in.Name)
|
|
}
|
|
if in.Brand != nil {
|
|
v.Brand = strings.TrimSpace(*in.Brand)
|
|
}
|
|
if in.Model != nil {
|
|
v.Model = strings.TrimSpace(*in.Model)
|
|
}
|
|
if in.PlateNumber != nil {
|
|
v.PlateNumber = strings.TrimSpace(*in.PlateNumber)
|
|
}
|
|
if in.FuelType != nil {
|
|
v.FuelType = strings.TrimSpace(*in.FuelType)
|
|
}
|
|
if in.TankCapacity != nil {
|
|
v.TankCapacity = *in.TankCapacity
|
|
}
|
|
if in.CurrentOdometer != nil {
|
|
v.CurrentOdometer = *in.CurrentOdometer
|
|
}
|
|
if v.Name == "" {
|
|
return nil, apperror.New(apperror.CodeInvalidArg, "车辆名称不能为空")
|
|
}
|
|
if v.FuelType == "" {
|
|
return nil, apperror.New(apperror.CodeInvalidArg, "能源类型不能为空")
|
|
}
|
|
|
|
// 切换默认车辆同样要在事务里:先清默认,再置新默认
|
|
if in.DefaultVehicle != nil && *in.DefaultVehicle && !v.DefaultVehicle {
|
|
err := s.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
|
|
if err := s.repo.ClearDefault(ctx, tx); err != nil {
|
|
return err
|
|
}
|
|
v.DefaultVehicle = true
|
|
if err := tx.WithContext(ctx).Save(v).Error; err != nil {
|
|
return apperror.Wrap(apperror.CodeInternal, "更新车辆失败", err)
|
|
}
|
|
return nil
|
|
})
|
|
if err != nil {
|
|
if appErr, ok := apperror.As(err); ok {
|
|
return nil, appErr
|
|
}
|
|
return nil, err
|
|
}
|
|
return v, nil
|
|
}
|
|
|
|
if err := s.repo.Update(ctx, v); err != nil {
|
|
return nil, err
|
|
}
|
|
return v, nil
|
|
}
|
|
|
|
func (s *vehicleService) Delete(ctx context.Context, id uint64) error {
|
|
return s.repo.Delete(ctx, id)
|
|
}
|
|
|
|
func (s *vehicleService) SetDefault(ctx context.Context, id uint64) (*model.Vehicle, error) {
|
|
// 校验存在
|
|
if _, err := s.repo.Get(ctx, id); err != nil {
|
|
return nil, err
|
|
}
|
|
err := s.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
|
|
if err := s.repo.ClearDefault(ctx, tx); err != nil {
|
|
return err
|
|
}
|
|
return s.repo.SetDefault(ctx, tx, id)
|
|
})
|
|
if err != nil {
|
|
if appErr, ok := apperror.As(err); ok {
|
|
return nil, appErr
|
|
}
|
|
return nil, err
|
|
}
|
|
return s.repo.Get(ctx, id)
|
|
}
|