BAI Project

A Go web service following clean architecture patterns with Templ templating.

Quick Start

1. Ensure you have Go and Templ installed
2. Run ./dev.sh to start development with live reload
3. Access the app at http://localhost:7331 (proxied from :8080)

The dev script automatically:

• Generates Go code from .templ files
• Restarts the server on file changes
• Reloads your browser automatically

Architecture

• Framework: Fiber
• Templates: Templ
• Dev Tools: Templ's built-in live reload
• Pattern: Clean architecture with dependency injection

Structure

• cmd/api/ - Application entry point
• config/ - Configuration management via .env
• internal/app/ - DI container
• internal/controllers/ - Business logic orchestration
• internal/handlers/ - HTTP request handlers
• internal/middleware/ - HTTP middleware
• internal/repositories/ - Data access layer
• internal/services/ - Business logic services
• internal/server/ - Fiber server setup
• views/ - Templ HTML templates

Development

# Start development server with live reload
./dev.sh

# Run tests
go test ./...

# Run linter (if golangci-lint is installed)
golangci-lint run

API Endpoints

• GET /api/health - Health check
• GET /api/home - Home endpoint (returns "Hello World")