vollversammlung/AGENTS.md

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
• Doku/umsetzung.md → Aktueller Projektfortschritt (immer aktuell halten!)

Arbeitsweise

• Immer einen Subagent starten für parallele Arbeit (z.B. Backend + Frontend gleichzeitig)
• Fortschritt unter Doku/umsetzung.md speichern und aktualisieren

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

Wichtige Pfad-Convention

• Alle Pfade mit Doku/, .opencode/, api/, frontend/ immer relativ zum Workspaceroot
• Niemals Annahmen über Pfadnamen treffen – bei Unsicherheit zuerst ls oder glob verwenden
• Im Zweifel immer den aktuellen Pfad über das Terminal prüfen (z. B. pwd) bevor Dateioperationen erfolgen