Atlas Schema Management (Go/GORM)

This project uses Atlas for database schema management with GORM models.

Quick Start

When the schema changes, generate a new migration:

bash

atlas migrate diff --env gorm <migration_name>

Key Commands

Task	Command
Generate migration	`atlas migrate diff --env gorm <name>`
Validate migrations	`atlas migrate validate --env gorm`
Check status	`atlas migrate status --env gorm`
Fix checksums	`atlas migrate hash --env gorm`

Workflow for Schema Changes

•Modify GORM models in models/ directory
•Generate migration: atlas migrate diff --env gorm add_description_field
•Review the generated SQL in migrations/
•Validate: atlas migrate validate --env gorm
•Run tests: go test ./...

Critical Rules

⚠️ NEVER modify existing migration files - this breaks linear history ⚠️ ALWAYS create NEW migrations for schema changes ⚠️ Run atlas migrate hash if you must edit an unapplied migration

Common Issues

Migration Validation Failed

bash

atlas migrate validate --env gorm
# Fix issues, then:
atlas migrate hash --env gorm

Project Structure

code

├── atlas.hcl          # Atlas configuration
├── models/            # GORM models (source of truth)
│   └── todos.go
├── migrations/        # Atlas versioned migrations
│   ├── atlas.sum      # Integrity checksums (don't edit)
│   └── *.sql          # Migration files

The atlas.hcl uses atlas-provider-gorm to read GORM model definitions and compare them against the migrations directory.