Initial commit: Docker infrastructure for fullstack Vollversammlung app

This commit is contained in:
2026-06-28 15:37:48 +02:00
commit 2960855bca
21 changed files with 1434 additions and 0 deletions
+40
View File
@@ -0,0 +1,40 @@
# Vollversammlung Agent Instructions
## Project
Mandantenfähiges Veranstaltungs-Tool mit Anwesenheitsverwaltung und Statistik.
- Backend: Symfony (manuelle Controller, keine API Platform)
- Frontend: React
- DB: PostgreSQL (Multi-Tenant, Scoping per MandantID)
- Auth: externer OAuth (Vonova), kein lokaler Login
- Logging: Mercure
- Infrastruktur: Docker / docker-compose
## Structure (planned)
```
vollversammlung/
├── .opencode/ ← OpenCode agents + config (opencode.json)
├── Doku/ ← Planungsdokumente, Architektur
├── api/ ← Symfony Backend
└── frontend/ ← React Frontend
```
## Key constraints the repo doesn't make obvious
- Personen haben **keine** email/benutzername-Felder OAuth liefert Identität extern
- Mandantenisolation ist core: alle Daten pro MandantID scoped, keine Überschneidung
- Auth-Tokens niemals im Client-Speicher (localStorage/sessionStorage)
- Session-Cookies: HttpOnly, Secure, SameSite=lax
- Input-Validierung auf jeder Schicht: Frontend + API + DB-Level
## Agent config
Agents are defined in `.opencode/opencode.json` and `.opencode/agents/*.md`. They cover six roles: architekt, db-architekt, backend-coder, frontend-coder, tester, devops-coder. Loading agent instructions from `.opencode/` is the primary configuration surface no other OpenCode config files exist at root level.
## Referenzen
- `Doku/architektur.md` → Backend Architektur mit struktur & Konventionen (Provider/Processor-Pattern, Multi-Tenant Scoping)
- `Doku/plan.md` → Domain-Details und Entity-Spezifikationen (Veranstaltung, Personen, Anwesenheit)
- `Doku/agents_planung.md` → 4-Phasen-Agent-Arbeitsverteilung
## What to do on first session in api/ or frontend/
1. Read `.opencode/opencode.json` for agent definitions
2. Read `Doku/architektur.md` und `Doku/plan.md` für Architektur und Domain-Anforderungen
3. Read the relevant agent file from `.opencode/agents/` fur implementierung-Konventionen
4. Prüfe ob Infrastruktur eingerichtet ist (docker-compose.yaml, .env.example) vor Code-Schreiben