Architecture and Operations
This section explains how the fitness application is structured, how it runs on-premises, and how the different services talk to each other. It also links to the deployment, Kubernetes, and webhook details so I can come back later and repeat the setup.
Blaster Architecture and Code Structure
How Blaster is put together. Next.js, Phaser, PostgreSQL, migrations, and API routes.
Data Models
Scoped to Stage 1 (foundation for personal coach – running data).
Deployment and Setup Guide
Production-ready setup for self-hosted fitness tracking.
Design Decisions
Default maximum pods
Hybrid Cluster
Replace the virtual worker with a physical node to make the development cluster hybrid. This adds realistic CPU, memory, storage, and network performance while keeping the control plane simple and virtualised.
Hybrid Cluster Playbook
Install and join process for the physical node.
Hybrid Cluster Validation
Validation commands and expected outputs.
Kubernetes Deployment
Kubernetes notes for Stage 1.
Strava Webhooks Implementation
This document describes the complete webhook implementation for real-time Strava activity notifications.
System Services
High-level services and how they communicate.
Technical Context
Short context of the stack and why I chose it. Scope: Stage 1.