Prompt file imported from cdalsoniii/brightpath-coder (.cursor/commands/domain-scaffold.md). Copyright stays with the author.

Domain Scaffold

Usage

Invoke with the entity name and type:

• /domain-scaffold Account — scaffold a new entity named Account

Steps

1. Validate entity name: Ensure PascalCase naming, no conflicts with existing models

2. Generate model: Create internal/models/<entity>.go with:

   • UUID primary key with gorm:"type:text;primaryKey"
   • Standard timestamps (CreatedAt, UpdatedAt)
   • TableName() method
   • BeforeCreate() hook for UUID generation
   • Status enum with validation method (if applicable)
   • Follow patterns from rule 122 (GORM conventions)

3. Generate repository interface: Add to internal/repository/repository.go:

   • Create, FindByID, FindAll (paginated), Update, Delete methods
   • Follow repository patterns from rule 125 (layer boundaries)

4. Generate service: Create internal/service/<entity>_service.go with:

   • Constructor function New<Entity>Service(db *gorm.DB, repo <Entity>Repository)
   • CRUD methods with proper error wrapping per rule 124
   • Sentinel errors for not-found, validation failures

5. Generate handler: Create internal/handler/<entity>_handler.go with:

   • Service interface defined locally (handler owns the interface)
   • CRUD endpoint handlers
   • Proper DTO conversion (request → service params, models → response)
   • Error-to-HTTP mapping per rule 124

6. Generate DTOs: Create internal/dto/request/<entity>.go and internal/dto/response/<entity>.go

7. Generate test stubs: Create internal/models/<entity>_test.go, internal/service/<entity>_service_test.go with table-driven test structure

8. Register in database: Add model to AutoMigrate in internal/database/database.go

9. Wire in main: Add service and handler initialization in cmd/api/main.go