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/

Read .opencode/opencode.json for agent definitions
Read Doku/architektur.md und Doku/plan.md für Architektur und Domain-Anforderungen
Read the relevant agent file from .opencode/agents/ fur implementierung-Konventionen
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

2.6 KiB Raw Blame History Unescape Escape