# INSIGHT MVP - Aenderungsprotokoll

## Stand: 2026-03-08

### Aktueller Sprint: Sprint 1 (Alpha)

---

### Aenderungen in dieser Session

#### 1. Projektinitialisierung & Infrastruktur-Definition

**Was wurde gemacht:**

1. **SSH Keys erstellt**
   - Deploy-Key (`.keys/deploy_ed25519`) fuer Server-Zugriff
   - CI/CD-Key (`.keys/cicd_ed25519`) fuer Forgejo Actions Pipeline

2. **Infrastruktur-Definition erstellt** (`docs/INFRASTRUCTURE.md`)
   - ProxmoxVE VM-Spezifikation: Ubuntu 24.04 LTS, 4 vCPU, 8 GB RAM, 60 GB SSD
   - Docker-Netzwerk-Architektur mit 3 isolierten Netzwerken
   - Komplette Service-Landschaft definiert
   - Schritt-fuer-Schritt VM-Setup Anleitung

3. **Zugangsdaten-Dokument erstellt** (`docs/ACCESS.md`)
   - Server-IP: 172.20.10.59 (insight-dev-01)
   - Git-Server: 172.20.10.11 (GAIA-GIT)
   - Alle SSH-Keys, Ports, Befehle dokumentiert

4. **Projektstruktur aufgesetzt** (packages/core-service, packages/frontend, config, .forgejo)

5. **Basis-Konfigurationsdateien** (.gitignore, .env.example, README.md)

#### 2. Forgejo Git-Server Konfiguration

**Was wurde auf dem Git-Server (172.20.10.11) gemacht:**

1. **Docker Engine 29.3 installiert** (fuer Forgejo Actions Runner)
2. **Forgejo Actions aktiviert** (`[actions] ENABLED = true` in app.ini)
3. **Container Registry aktiviert** (`[packages] ENABLED = true` in app.ini)
4. **Forgejo Runner v6.3.1 installiert und registriert**
   - Runner-Name: `insight-runner`
   - Labels: `ubuntu-latest` (docker://node:20)
   - Laeuft als Systemd-Service (`forgejo-runner.service`)
5. **Repository Secrets angelegt:**
   - `SSH_DEPLOY_KEY` - CI/CD Private Key
   - `DEPLOY_HOST` - 172.20.10.59
   - `DEPLOY_USER` - deploy
   - `REGISTRY_USER` - gitadmin
   - `REGISTRY_PASSWORD` - Forgejo Access Token
6. **Branch Protection eingerichtet:**
   - `main`: Kein direkter Push, 1 Approval erforderlich
   - `develop`: Kein direkter Push, 1 Approval erforderlich
7. **Forgejo Setup-Anleitung erstellt** (`docs/FORGEJO_SETUP.md`)

---

### Naechste Schritte

- [ ] SSH Deploy Keys auf insight-dev-01 Server hinterlegen
- [ ] `docker-compose.yml` erstellen (alle Basis-Services)
- [ ] `docker-compose.observability.yml` erstellen
- [ ] NestJS Core-Service implementieren (Auth, Users, Tenants)
- [ ] Prisma-Schemas erstellen (core + tenant)
- [ ] React Frontend-Shell implementieren
- [ ] CI/CD Pipelines (.forgejo/workflows/) definieren

---

### Offene Fragen / Abhaengigkeiten

- DNS-Eintrag `insight-dev.xinion.lan` muss auf 172.20.10.59 zeigen
- Deploy Keys muessen auf insight-dev-01 in authorized_keys hinterlegt werden