KennethCheng
bfa0d76222
Phase 1.3b。Phase 1.3a 留的 service 现在有了 HTTP 入口,curl 能跑通完整的
"建车 → 加三次油 → 看统计 → 删记录 → 删车"全链路,核心计算命中 plan §6。
新增:
- internal/handler/common.go 通用:writeError / parseUint64 / bindJSON / sendJSON
* 统一错误格式:{ "code": "INVALID_ARGUMENT|NOT_FOUND|...", "message": "..." }
* parseUint64 自动把非数字 / 0 翻成 INVALID_ARGUMENT
* bindJSON 把 gin-validator 错误也归到 INVALID_ARGUMENT
- internal/handler/errors.go errInvalid / errInvalidVehicleID 等小工具
- internal/handler/vehicle.go CRUD + SetDefault 六个端点
- internal/handler/refuel_record.go CRUD + List(?vehicle_id) + Statistics
- internal/router/router.go 把所有 /api 路由挂上 Gin engine
main.go 改动:
- 引入 wire():repository → service → handler 一气串好
- /api 业务路由从 router.Build 注入
- /health 与 NoRoute 保持原状
scripts/smoke.ps1 端到端冒烟脚本(13 步):
health → list → create vehicle → list → refuel×3(其中 1 个半箱)→
statistics → list refuels → delete refuel → statistics 刷新 →
delete vehicle → GET 404
核心计算命中 plan §6.3 / §19:
320/40 = 8.0 (price_per_liter) ✓
256/32 = 8.0 (price_per_liter) ✓
32/(11000-10500)*100 = 6.4 (L/100km) ✓
256/500 = 0.512 (元/公里) ✓
半箱油(11200/10L/is_full=false)不进入标准油耗采样 ✓
删除记录后 avg_consumption / cost_per_km 立即重算 ✓
期间踩到的两个坑(都修了):
1) handler 用 []struct{}{} 试图给 []model.Vehicle / []model.RefuelRecord
兜空数组,Go 强类型不接受;改用 []model.Vehicle{} 即可
2) Statistics 列表按 refuel_time DESC 返回,正向迭代会让 mileage 算成负数
(newer - older < 0);改成倒序迭代,prevFull 总是更老的那次
未做(留给后续):
- 单元测试(下一步 Phase 1.4 独立 commit)
- 显式 migration 文件(下次 schema 变更补;此次仍 AutoMigrate 兜底)
- Dashboard / 统计更复杂的 endpoint(基础 Statistics 已可用)
- PWA / 导入导出 / Docker(留给 Phase 1.5+)
验证:
go vet ./... 0 issues
go build 26 MB binary
smoke.ps1 13/13 断言通过
32 lines
921 B
Go
32 lines
921 B
Go
// Package router 负责组装 Gin 路由表。
|
|
package router
|
|
|
|
import (
|
|
"github.com/gin-gonic/gin"
|
|
|
|
"github.com/kennethcheng/fuellog-api/internal/handler"
|
|
)
|
|
|
|
// Build 在传入的 gin.Engine 上挂载 /api 业务路由。
|
|
// 引擎本身的 /health 与 NoRoute 由调用方(main)处理。
|
|
func Build(r *gin.Engine, vh *handler.VehicleHandler, rh *handler.RefuelHandler) {
|
|
api := r.Group("/api")
|
|
|
|
// 车辆
|
|
api.POST("/vehicles", vh.Create)
|
|
api.GET("/vehicles", vh.List)
|
|
api.GET("/vehicles/:id", vh.Get)
|
|
api.PUT("/vehicles/:id", vh.Update)
|
|
api.DELETE("/vehicles/:id", vh.Delete)
|
|
api.POST("/vehicles/:id/default", vh.SetDefault)
|
|
// 统计(挂在车辆下,语义清晰)
|
|
api.GET("/vehicles/:id/statistics", rh.Statistics)
|
|
|
|
// 加油记录
|
|
api.POST("/refuels", rh.Create)
|
|
api.GET("/refuels", rh.List)
|
|
api.GET("/refuels/:id", rh.Get)
|
|
api.PUT("/refuels/:id", rh.Update)
|
|
api.DELETE("/refuels/:id", rh.Delete)
|
|
}
|