6.1 Prerequisites

Ensure the following tools are installed on your workstation:

• Go: v1.22+
• Docker & Docker Compose: v24.0+
• Node.js & npm: v20.x+ (for frontend workspaces)
• Python: v3.11+ (for AI Assistant service)
• golangci-lint: v1.57+ (optional for local linting; enforced in CI)

6.2 Running Infrastructure Services

Start the authoritative PostgreSQL instance and RabbitMQ message broker:

# Start background infrastructure (PostgreSQL, RabbitMQ, Redis)
docker compose up -d postgres rabbitmq redis

6.3 Running Core API Service

# Navigate to Core API
cd core-api

# Execute database migrations
go run cmd/migrate/main.go up

# Start the Core API modular monolith
go run cmd/api/main.go

The Core API serves traffic on http://localhost:8080. Health probes are available at:

• Liveness Probe: GET http://localhost:8080/health/live
• Readiness Probe: GET http://localhost:8080/health/ready

6.4 Running the Asynchronous Workers

# In a separate terminal, launch Outbox Relay
cd services/messaging && go run cmd/relay/main.go

# Launch Event Worker (Notifications & Webhooks)
cd services/messaging && go run cmd/worker/main.go