Dit overzicht is bedoeld als referentie- en contextdocumentatie voor ontwikkelaars en AI-assistenten die werken binnen de werkmap /home/bart/git/cluster.

📌 Overzicht van de Workspace

De werkmap /home/bart/git/cluster is een centrale Git meta-repository (superproject) voor het private home-server / homelab Kubernetes cluster. De individuele subsystemen zijn gekoppeld als Git submodules en synchroniseren autonoom met de private Gitea-instantie (https://git.bnhmeijer.nl).

Submodules in deze repository

Submodule	Doel	Primaire technologieën
`cluster-infra/`	Infrastructurele services & middleware in K8s	K8s, Docker, Postgres, MongoDB, InfluxDB, RabbitMQ, Mosquitto, Dnsmasq, Apache/Nginx vhosts
`HERMS/`	Geautomatiseerd brouwplatform (Heat Exchange Recirculating Mash System)	Rust (Controller & Storage), Next.js / TypeScript (Frontend), ESP32 C++ (Firmware), KiCad (Hardware PCB), Python (Simulator)
`k8s-infra-vmserver/`	GitOps configuratie repository gemonitord door ArgoCD	Kubernetes Kustomize manifests, Gateway API (HTTPRoute)
`smart-home/`	Huisautomatisering en IoT integraties	Home Assistant / IoT configuraties

📑 Documentatie-index

Platform Overzicht & Architectuur: Integraal platformoverzicht, subsystemen, beveiliging en GitOps principes.
Systeemarchitectuur & GitOps: Hoe services, Gitea Actions pipelines, container registry, ArgoCD en Kubernetes samenwerken.
Live Cluster Status (10.2.0.4): Actuele status, node-specificaties, namespaces, pods, PVCs en HTTPRoutes van het actieve cluster.
Apache Reverse Proxy & VHosts: Details over Apache op 10.2.0.4, /sites/vhosts, TLS/OIDC terminatie en koppeling naar Envoy Gateway (NodePort 32608).
Repository Details & Modules: Gedetailleerde beschrijving van alle componenten, mappen, protocollen (MQTT, NATS) en functies.
Grasmaaier Automatisering (OpenMower / Mowgli): Yardforce 500 robotmaaier met Mowgli, ROS Noetic, RTK GPS, Docker stack, MQTT bridge en netwerkconfiguratie.
AI Cheatsheet & Developer Richtlijnen: Snelle referentie voor commando's, submodule workflows, conventies en valkuilen.