Files
breadcrumb-the-shire/docs/index.md
fs 25370a1a55 add composer-unused, comprehensive docs, and project restructure
- Add icanhazstring/composer-unused as dev dependency for dependency hygiene checks
- Add German documentation (docs/) covering architecture, conventions, workflows, and developer checklists
- Add API layer (ApiAuth, ApiBootstrap, ApiResponse), audit, scheduler, custom fields, and SSO services
- Add Microsoft OIDC SSO, API token management, and user lifecycle features
- Add swagger-ui vendor integration and OpenAPI spec
- Add production Docker setup and bin/ scripts
- Update composer dependencies, config, templates, and frontend assets throughout

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-22 15:27:35 +01:00

2.5 KiB

Dokumentation

Letzte Aktualisierung: 2026-02-21

Diese Dokumente sind für Entwickler gedacht, die die Anwendung warten oder erweitern.

Start hier (neue Entwickler)

  1. /docs/erste-schritte.md
    • Setup in 30-45 Minuten, erster Login, erster Smoke-Test.
  2. /docs/lokale-entwicklung.md
    • Täglicher Workflow, Schema-Updates und Qualitätschecks.
  3. /docs/erste-aenderung.md
    • Schritt-für-Schritt für den ersten kleinen Code-Change.
  4. /docs/dokumentation-erweitern.md
    • Wie neue Doku-Dateien sauber erstellt, einsortiert und suchbar gemacht werden.
  5. /docs/entwickler-checkliste.md
    • Finale Checkliste vor Merge/Review.

Architektur und Regeln

  • /docs/architektur.md
    • Request-Lebenszyklus, Schichtentrennung, Frontend-Aufbau.
  • /docs/sicherheitsmodell.md
    • Auth, Permissions, Tenant-Scope, Public/API-Zugriffe.
  • /docs/konventionen.md
    • Coding- und Strukturkonventionen für PHP, Templates, CSS, JS.

Frontend

  • /docs/frontend-javascript.md
    • Frontend-JS-Aufbau, Init-Flow, Grid-Integration und URL-State-Sync.
  • /docs/frontend-css.md
    • CSS-Struktur, Layering, Vendor-Overrides und Asset-Einbindung.

Fach- und Feature-Dokumentation

  • /docs/benutzerdefinierte-felder.md
    • Tenant/User-Zusatzfelder (Typen, Pflege, Filterbarkeit).
  • /docs/importe.md
    • CSV-Import (V1), Mapping, Fehlercodes, Permission-Modell und Import-Audit.
  • /docs/einstellungen-speicherung.md
    • Source of truth für Settings (DB) und Datei-Cache-Verhalten.
  • /docs/anfragelimits.md
    • Login/API-Limits, Scopes, Block-Verhalten.
  • /docs/benutzer-lifecycle-policy.md
    • Automatische Benutzer-Deaktivierung/Löschung (Policy, Cron, manueller Run).
  • /docs/geplante-aufgaben.md
    • Zentrale geplante Aufgaben (Scheduler), Job-Konfiguration und Runner-Betrieb.
  • /docs/globale-suche.md
    • Globale Suche erweitern (Resource, Permission, Mapping, Aside-Integration).

API Referenz

  • /docs/api.md
    • API Quick Reference, Auth, Flows, Beispielaufrufe.
  • /docs/openapi.yaml
    • API Source of truth für Swagger UI.

Betriebswissen

  • /docs/konfiguration.md
    • Alle ENV-Variablen mit Beschreibung, Standardwerten und Produktions-Checkliste.
  • /docs/fehlerbehebung.md
    • Häufige Fehlerbilder und schnelle Lösungen.
  • /docs/docker-lokal.md
    • Schneller lokaler Docker-Start inkl. typischer Befehle und Troubleshooting.
  • /docs/docker-produktiv.md
    • Produktionsbetrieb mit Domain, TLS und docker-compose.prod.yml.
  • /docs/docker-betrieb.md
    • Einstieg und Navigation zwischen lokaler und produktiver Docker-Doku.