# INSIGHT MVP - Aenderungsprotokoll

## Stand: 2026-03-08

### Aktueller Sprint: Sprint 1 (Alpha)

---

### Aenderungen in dieser Session

#### Projektinitialisierung & Infrastruktur-Definition

**Was wurde gemacht:**

1. **SSH Deployment Key erstellt**
   - Ed25519-Schluessel unter `.keys/deploy_ed25519` generiert
   - Public Key muss auf dem Entwicklungsserver und in Forgejo hinterlegt werden
   - Key-Kommentar: `insight-deploy@xinion.lan`

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 (Traefik, Core, Frontend, PostgreSQL, PgBouncer, Redis, step-ca)
   - Observability-Stack definiert (Prometheus, Grafana, Loki, Tempo, Promtail, cAdvisor)
   - Schritt-fuer-Schritt VM-Setup Anleitung

3. **Zugangsdaten-Dokument erstellt** (`docs/ACCESS.md`)
   - Git Repository Zugangsdaten
   - SSH-Key Dokumentation und Verwendung
   - Server-Zugangsdaten (Platzhalter fuer IP)
   - Alle Service-Ports dokumentiert
   - Deployment-Pfad dokumentiert
   - Wichtige Befehle (MacBook & Server)

4. **Projektstruktur aufgesetzt**
   - Verzeichnisstruktur gemaess Briefing angelegt
   - packages/core-service/ (NestJS Backend)
   - packages/frontend/ (React + Vite)
   - config/ (Traefik, Prometheus, step-ca)
   - .forgejo/workflows/ (CI/CD)

5. **Basis-Konfigurationsdateien erstellt**
   - `.gitignore` - alle relevanten Ausschluesse
   - `.env.example` - alle Umgebungsvariablen dokumentiert (ohne Werte)
   - `README.md` - vollstaendiges Onboarding-Dokument

---

### Naechste Schritte

- [ ] VM in ProxmoxVE erstellen und konfigurieren
- [ ] SSH Deploy Key auf Server und in Forgejo 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 in Forgejo Actions definieren

---

### Offene Fragen / Abhaengigkeiten

- Server-IP wird erst bei VM-Erstellung vergeben
- DNS-Eintraege (insight-dev.xinion.lan) muessen konfiguriert werden
- Forgejo Deploy Key muss manuell hinterlegt werden