kAIzen Coach Documentation

AI-powered endurance coaching application with multi-environment deployment on AWS and GCP.

• 🏗️ Architecture
• 🚀 Deployment & Setup
• 📊 Current Infrastructure
  • Environments
  • Stack
  • Monthly Costs
• 🔗 Quick Links

---

🏗️ Architecture

Understanding the application structure and data flow:

• Application Flow Visualization - Interactive architecture diagram
• Architecture Overview - Detailed architecture documentation

---

🚀 Deployment & Setup

Complete guides for deploying and managing environments:

• Multi-Environment Setup - Complete AWS and GCP setup guide
• New Environment Deployment - Step-by-step deployment process
• Secrets Management Guide - All secrets explained with generation commands

---

📊 Current Infrastructure

Environments

• Production: www.kaizencoach.training
• Staging: staging.kaizencoach.training
• Dev: Local development environment

Stack

• Frontend: Flask, Tailwind CSS, Chart.js
• Backend: AWS App Runner, DynamoDB, S3
• AI: Google Vertex AI (Gemini 2.5 Flash)
• Integrations: Strava OAuth2, Garmin Connect
• Infrastructure: Terraform, Docker, AWS ECR

Monthly Costs

• Production: ~$30/month (always-on)
• Staging: ~$8/month (low-cost)
• Dev: ~$0/month (local only)

---

🔗 Quick Links

• GitHub Repository
• Live Application
• Staging Environment

---

Last updated: December 2025 | Edit on GitHub