# Cluster Workspace Documentatie

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/`](file:///home/bart/git/cluster/cluster-infra)** | Infrastructurele services & middleware in K8s | K8s, Docker, Postgres, MongoDB, InfluxDB, RabbitMQ, Mosquitto, Dnsmasq, Apache/Nginx vhosts |
| **[`HERMS/`](file:///home/bart/git/cluster/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/`](file:///home/bart/git/cluster/k8s-infra-vmserver)** | GitOps configuratie repository gemonitord door ArgoCD | Kubernetes Kustomize manifests, Gateway API (HTTPRoute) |
| **[`smart-home/`](file:///home/bart/git/cluster/smart-home)** | Huisautomatisering en IoT integraties | Home Assistant / IoT configuraties |

---

## 📑 Documentatie-index

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