From 63e8a684897c98faab06c7555c9ab8d791948272 Mon Sep 17 00:00:00 2001
From: bart <bart@reprapworld.com>
Date: Tue, 20 Oct 2026 21:25:22 +0200
Subject: [PATCH] Update AGENTS.md with eendoeserver and package-repo
 instructions

---
 AGENTS.md | 30 +++++++++++++++++++++++++++++-
 1 file changed, 29 insertions(+), 1 deletion(-)

diff --git a/AGENTS.md b/AGENTS.md
index 27ae8ef..a2978af 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -14,6 +14,8 @@ Het platform omvat:
 * **HERMS Brouwplatform**: Geautomatiseerd Heat Exchange Recirculating Mash System (Rust microservices, Next.js frontend, ESP32 firmware, KiCad hardware).
 * **Smart Home**: Home Assistant en IoT-koppelingen binnen Kubernetes.
 * **HTPC & Media**: Jellyfin, `*Arr`-stack en downloadvoorzieningen.
+* **Web & Reverse Proxy (`eendoeserver`)**: Apache VirtualHosts, reverse proxy configuraties en de website van `eendoe.nl` op `web03`.
+* **Software Distributie (`package-repo`)**: Debian / APT package repository bronnen, build-scripts en CI/CD packaging pipelines.
 
 ---
 
@@ -134,6 +136,23 @@ flowchart TD
 * Bevat ArgoCD ApplicationSets en Kustomize base/overlay structuren voor het cluster.
 * Map `workloads/` bevat gesynchroniseerde manifests voor `cluster-infra`, `herms`, `demo` en `htpc`.
 
+### 🏢 eendoeserver (`eendoeserver/`)
+* Bevat de configuratie en bestanden voor de standalone server `web03` (`eendoe.nl`):
+  * **`eendoe/`**: Document root voor de website `eendoe.nl` en `bm4.nl` (HTML, SASS, CSS, JS, afbeeldingen).
+  * **`vhosts/`**: Apache 2.4 VirtualHost configuraties (geïncludeerd via `Include /sites/vhosts/*.conf`).
+* **Regels**:
+  * Grote binaire installers (zoals `.AppImage` of losse `.deb` installatiebestanden) horen **niet** thuis in git, maar worden beheerd via `package-repo` of downloads.
+
+### 📦 package-repo (`package-repo/`)
+* Bevat de bronbestanden en distributiestructuur voor de Debian/APT package repository van Eendoe:
+  * **`sources/`**: Bevat bronbestanden per package (bijv. `eendoe_repository`, `eendoe_hyperdeck`, `eendoe_srs`) met hun control templates en `bin/build.sh`.
+  * **`staging/`**: Bestemming voor nieuw gebouwde en bestaande `.deb` pakketten.
+  * **`binaries/`**: Publiek geserveerde repository bestanden (`pool/`, `dists/`).
+  * **`buildpackages.sh`**: Universeel build-script om packages direct te genereren.
+  * **`.gitea/workflows/build-and-publish.yaml`**: CI/CD pipeline voor automatische package-builds en SSH/rsync deployments.
+* **Belangrijke regel**:
+  * **Nooit** grote externe database installatiebestanden (zoals Oracle Database XE deb packages van >2 GB) toevoegen aan deze repository.
+
 ---
 
 ## 🛠️ 6. Handige Commando's voor Agents
@@ -141,7 +160,7 @@ flowchart TD
 ### Submodule & Git Beheer
 ```bash
 # Submodule status en eventuele uncommitted changes inspecteren
-for d in cluster-infra HERMS k8s-infra-vmserver smart-home htpc; do
+for d in cluster-infra HERMS k8s-infra-vmserver smart-home htpc eendoeserver package-repo; do
   echo "=== $d ==="
   git -C "$d" status -s
 done
@@ -153,6 +172,15 @@ git submodule update --remote --merge
 git submodule update --init --recursive
 ```
 
+### Debian Packages Bouwen (`package-repo`)
+```bash
+# Alle debian packages in sources/ compileren
+./package-repo/buildpackages.sh all
+
+# Een specifiek package compileren
+./package-repo/buildpackages.sh eendoe_hyperdeck
+```
+
 ### Kubernetes & Kustomize Inspectie
 ```bash
 # Pods bekijken over alle relevante namespaces