goplt/docs/content/stories/phase0/README.md

Phase 0: Project Setup & Foundation

Overview

Initialize repository structure, set up Go modules and basic tooling, create configuration management foundation, and establish CI/CD skeleton.

Tasks

0.1 Repository Bootstrap

• 0.1.1 - Initialize Go Module
• 0.1.2 - Create Directory Structure
• 0.1.3 - Add Gitignore
• 0.1.4 - Create Initial README

0.2 Configuration System

• 0.2.1 - Install Configuration Dependencies
• 0.2.2 - Create Config Interface
• 0.2.3 - Implement Config Loader
• 0.2.4 - Create Configuration Files

0.3 Logging Foundation

• 0.3.1 - Install Logging Dependencies
• 0.3.2 - Create Logger Interface - Create pkg/logger/logger.go interface
• 0.3.3 - Implement Zap Logger - Implement internal/logger/zap_logger.go
• 0.3.4 - Add Request ID Middleware - Create Gin middleware for request IDs

0.4 Basic CI/CD Pipeline

• 0.4.1 - Create GitHub Actions Workflow
• 0.4.2 - Create Makefile

0.5 Dependency Injection Setup

• 0.5.1 - Install FX Dependency
• 0.5.2 - Create DI Container
• 0.5.3 - Create Main Entry Point

Deliverables Checklist

• Repository structure in place
• Configuration system loads YAML files and env vars
• Structured logging works
• CI pipeline runs linting and builds binary
• Basic DI container initialized

Acceptance Criteria

• go build ./cmd/platform succeeds
• go test ./... runs (even if tests are empty)
• CI pipeline passes on empty commit
• Config loads from config/default.yaml