2 changed files with 19 additions and 0 deletions
@@ -21,6 +21,16 @@ This is a **GitOps-based Kubernetes deployment** of **Element Server Suite (ESS
 - **NetworkPolicies**: default-deny-with-explicit-allow across `matrix` and `authentik` namespaces
 - **`host-config/`**: the one part of this repo that is deliberately **not** managed by Flux/GitOps — see "Host-Level (non-GitOps) Changes" below

+## Repo Topology (since 2026-07-31)
+
+Canonical repo is **`git.lab/axion1337.chat/axion1337.chat-gitops`** (homelab GitLab,
+resolvable only inside the lab) — all pushes go there; a push-mirror updates the Gitea
+copy on `rohana.axion1337.de`, which remains the **Flux source** (the cluster pulls from
+Gitea; the mirror delivers). **Never push directly to Gitea** for this repo — the mirror
+force-overwrites divergent state. Issues/wiki/releases stay on Gitea. The same rule
+applies to ThreadNet-Web, threadnet-call, thread-net-git and threadnet-operating; only
+the `Backlogs` repo (and this repo's wiki) are still direct-to-Gitea.
+
 ## Repository Structure

 ```
@@ -136,6 +136,15 @@ Weitere Secret-Dateien liegen direkt unter `apps/production/` bzw. `apps/authent
 `authentik-backup-secret.yaml`) - jede einzeln SOPS-verschlüsselt, nicht in `custom-configs/`
 gebündelt.

+### Repo-Topologie (seit 2026-07-31)
+
+**Kanonisch ist `git.lab/axion1337.chat/axion1337.chat-gitops`** (Homelab-GitLab, nur im
+Lab auflösbar) — dort wird gepusht und läuft der CI-Verifikations-Job (`.gitlab-ci.yml`).
+Die Kopie auf `rohana.axion1337.de` ist ein automatischer **Push-Mirror** und bleibt die
+**Flux-Quelle**: der Cluster zieht unverändert von Gitea, der Mirror liefert. **Niemals
+direkt nach rohana pushen** — der Mirror überschreibt divergente Stände. Issues, Wiki und
+Releases bleiben auf Gitea.
+
 **Abhängigkeits-Logik:** Flux installiert erst `infra-apps` (damit Namespaces und Repositories existieren) und danach `production-apps` (das eigentliche ESS-Chart).

 -----