KennethCheng
ca9831a050
Phase 1 of FuelLog backend bootstrap. Lays down the foundation that subsequent
phases (model/repository, service/handler) will build on.
What's in:
- go.mod / go.sum: Go 1.22 module, deps:
* gin-gonic/gin v1.10.0 HTTP framework
* glebarez/sqlite v1.11.0 pure-Go SQLite (no CGO, friendly to Windows + Docker)
* gorm.io/gorm v1.25.12 ORM (will be wired in Phase 1.2)
* shopspring/decimal v1.4.0 amount precision
* joho/godotenv v1.5.1 .env loader
- cmd/server/main.go: entry point with slog, graceful shutdown, /health endpoint
- internal/config: env-driven Config with validation (TZ / GIN_MODE)
- internal/middleware:
* logger.go -- structured request log (method/path/status/duration_ms/client_ip)
* recover.go -- panic capture to unified 500 response + stack to log
* cors.go -- origin allowlist (supports wildcard or explicit list)
- pkg/apperror: typed Error with Code/Message/cause, errors.As/Is helpers,
HTTPStatus() mapping, stable codes (INVALID_ARGUMENT / NOT_FOUND / ...)
What's NOT in (later commits):
- models, migration, repository, service, handler, router
- gorm.Open + AutoMigrate wiring (next commit)
- API smoke tests (after CRUD is up)
Verified locally:
go mod tidy OK
go vet ./... 0 issues
go build 12.8MB exe in fuellog-api/bin/server.exe
smoke test GET /health -> 200 {"status":"ok","time":"..."}
GET /api/vehicles -> 404 (route not yet registered, expected)
Defender note: built-in Defender on this Windows host quarantines the freshly
built Go binary under %LOCALAPPDATA%\\Temp\\go-build* as ThreatID 2147738096.
Workaround: GOTMPDIR=.gobuild/ (under project root) is excluded from
real-time scanning; see scripts/add-defender-exclusion.ps1.
60 lines
905 B
Plaintext
60 lines
905 B
Plaintext
# ===== OS =====
|
|
.DS_Store
|
|
Thumbs.db
|
|
desktop.ini
|
|
$RECYCLE.BIN/
|
|
|
|
# ===== IDE =====
|
|
.vscode/
|
|
.idea/
|
|
*.swp
|
|
*.swo
|
|
*.iml
|
|
.cursor/
|
|
|
|
# ===== Logs =====
|
|
*.log
|
|
logs/
|
|
|
|
# ===== Env / Secrets =====
|
|
.env
|
|
.env.local
|
|
.env.*.local
|
|
*.pem
|
|
*.key
|
|
secrets/
|
|
|
|
# ===== Backend (Go) =====
|
|
fuellog-api/bin/
|
|
fuellog-api/dist/
|
|
fuellog-api/coverage.out
|
|
fuellog-api/*.test
|
|
fuellog-api/*.out
|
|
fuellog-api/.air.toml.local
|
|
# Go build temp output (used because Defender blocks the default %LOCALAPPDATA%\Temp)
|
|
.gobuild/
|
|
|
|
# ===== Database (SQLite) =====
|
|
# Keep the data/ directory, but ignore runtime DB files
|
|
data/*.db
|
|
data/*.db-journal
|
|
data/*.db-shm
|
|
data/*.db-wal
|
|
|
|
# ===== Frontend (Node / Vue) =====
|
|
fuellog-web/node_modules/
|
|
fuellog-web/dist/
|
|
fuellog-web/dist-ssr/
|
|
fuellog-web/.vite/
|
|
fuellog-web/*.local
|
|
fuellog-web/.nuxt/
|
|
fuellog-web/.next/
|
|
fuellog-web/.cache/
|
|
|
|
# ===== Coverage =====
|
|
coverage/
|
|
.nyc_output/
|
|
|
|
# ===== Docker =====
|
|
*.pid
|