infrapuzzle/README.md

Infrapuzzle 🧩

Infrapuzzle is the monorepo for personal infrastructure, Kubernetes cluster operations, DNS, IoT monitoring, and hosted applications.

Repository Layout

• bootstrap/: Provisioning the single-node Kubernetes cluster (haumdaucher) using Kubespray.
• k8s/: Kubernetes workloads. Every subdirectory represents a Kubernetes namespace.
• terraform/: Declarative Infrastructure as Code for core cloud infrastructure (OVH DNS zones, Authentik SSO, Google Workspace, and GCP APIs).
• projects/: Self-contained hosted applications and projects:
  • projects/shelly_taupunktluefter/: Smart home Shelly Plug S ventilation controller ("Taupi") for cellar mold prevention.
  • projects/sasch40/: Retro birthday adventure game (sasch40.haumdaucher.de).
  • projects/moritzgrafde/: Personal homepage and executive portfolio (moritzgraf.de).
  • projects/haumdaucherde/: Official community website & portal (haumdaucher.de).
  • projects/grabengasse/: Climate & weather dashboard (grabengasse7.de).
  • projects/esphome_display_kitchen/: ESP32 e-Paper kitchen status display & flashing wizard.
  • projects/duckdb-backend/: In-memory analytics and tracking query API.
  • projects/mila/: Baby tracking PWA (family.haumdaucher.de/tracking/mila).
  • projects/moritz/: Health and nutrition dashboard (family.haumdaucher.de/tracking/moritz).
• monitoring/: ESPHome fleet for BLE ambient room temperature & humidity sensors.
• fritzbox/: Home router Site-to-Site WireGuard VPN coupling and DynDNS synchronization.
• scripts/: Operational utility scripts (e.g. htpasswd.py).
• knowledge-wiki/: Shared personal knowledge base and OpenClaw task queue submodule.
• docs/: Architecture Decision Records (ADRs) following the MADR standard.

For architectural standards and operational guidelines, refer to AGENTS.md.