fa/breadcrumb-the-shire
1
0
Fork 1
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity
Files
015d911ef8cb5e114aa85c503e9f6c2a0d7d5fbb
breadcrumb-the-shire/docs/index.md

111 lines
4.7 KiB
Markdown
Raw Normal View History

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
# Dokumentation
chore(agents): implement v2 hardening and enforcement-ready QA
2026-04-01 19:41:56 +02:00
Letzte Aktualisierung: 2026-04-01
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
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
Diese Dokumentation ist nach dem Diataxis-Modell in vier Quadranten gegliedert: Tutorials zum Lernen, How-to Guides zum Nachschlagen von Aufgaben, Explanation zum Verstehen und Reference zum Nachschlagen von Fakten.
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
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
## Tutorials
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
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
1. `/docs/tutorial-01-erste-schritte.md`
- Schnellstart: Repo klonen, Container starten, erster Login.
2. `/docs/tutorial-02-systemueberblick.md`
major update
2026-03-04 15:56:58 +01:00
- Produktbild, Kernmodule und Lernziel in 10 Minuten.
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
3. `/docs/tutorial-03-setup-und-erster-login.md`
major update
2026-03-04 15:56:58 +01:00
- Lokales Setup, erster Login, erster Smoke-Test.
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
4. `/docs/tutorial-04-architektur-request-flow.md`
major update
2026-03-04 15:56:58 +01:00
- Request-Flow, Schichtmodell, Do/Don't.
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
5. `/docs/tutorial-05-erste-aenderung-ui.md`
- Erste sichere UI-Aenderung im Admin-Bereich.
6. `/docs/tutorial-06-erste-aenderung-backend.md`
- Erste Backend-/Service-/Repository-Aenderung.
7. `/docs/tutorial-07-security-tenant-scope.md`
major update
2026-03-04 15:56:58 +01:00
- Sicherheitsgrundlagen, Tenant-Scope, Pflichtchecks.
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
8. `/docs/tutorial-08-api-erweitern.md`
- API-Aenderung sauber mit OpenAPI und Tests umsetzen.
9. `/docs/tutorial-09-advanced-scheduler-sso.md`
major update
2026-03-04 15:56:58 +01:00
- Fortgeschrittene Themen: Scheduler, Lifecycle, SSO.
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
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
## How-to Guides
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
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
- `/docs/howto-erste-aenderung.md`
- Schritt-fuer-Schritt durch die erste Codeaenderung.
- `/docs/howto-globale-suche.md`
major update
2026-03-04 15:56:58 +01:00
- Neue Resource in der globalen Suche integrieren.
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
- `/docs/howto-importe.md`
major update
2026-03-04 15:56:58 +01:00
- Importfluss, Regeln und Fehlercodes.
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
- `/docs/howto-benutzerdefinierte-felder.md`
major update
2026-03-04 15:56:58 +01:00
- Tenant/User-Zusatzfelder korrekt erweitern.
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
- `/docs/howto-geplante-aufgaben.md`
major update
2026-03-04 15:56:58 +01:00
- Neue Scheduler-Jobs registrieren und betreiben.
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
- `/docs/howto-auth-sso-smoke-test.md`
- SSO-Funktionalitaet manuell verifizieren.
- `/docs/howto-anfragelimits.md`
major update
2026-03-04 15:56:58 +01:00
- Rate-Limits verstehen und testen.
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
- `/docs/howto-rbac-permissions-playbook.md`
- RBAC-Rechte sauber erweitern (neue Permission, neue Ability, UI/API-Faelle).
- `/docs/howto-request-input-validation.md`
- Einheitliches Request/Input- und Validation-Muster fuer Web + API.
- `/docs/howto-docker-lokal.md`
major update
2026-03-04 15:56:58 +01:00
- Lokaler Docker-Betrieb.
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
- `/docs/howto-docker-produktiv.md`
major update
2026-03-04 15:56:58 +01:00
- Produktivbetrieb mit Docker.
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
- `/docs/howto-betriebscheck-doctor.md`
docs: add CLI command reference and update key docs to use bin/console New docs/reference-cli-commands.md covers all commands, bootstrap helpers, and how to add new commands. Updated lokale-entwicklung, entwickler-checkliste, betriebscheck-doctor, index, and web/index.php error message to reference bin/console instead of legacy bin/*.php scripts. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 19:25:38 +01:00
- Schneller Systemcheck mit `php bin/console doctor`.
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
- `/docs/howto-fehlerbehebung.md`
- Haeufige Fehler und schnelle Loesungen.
- `/docs/howto-lokale-entwicklung.md`
- Tages-Workflow fuer Entwicklung und Checks.
docs: add module creation tutorial and improve make:module guidance Add howto-modul-erstellen.md covering the full module creation workflow: scaffold, manifest, container registration, first page, sync, validate, and test. Includes 9 extension point examples, merge checklist, and troubleshooting table. Documents the AuthorizationPolicy container registration requirement (policies with constructor params must be explicitly registered). Update make:module command output to reference the tutorial, manifest contract, and notifications as reference module. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-26 13:14:16 +01:00
- `/docs/howto-modul-erstellen.md`
- Neues Modul erstellen: Scaffold, Manifest, Route, Permission, UI-Slot, Test.
chore(agents): implement v2 hardening and enforcement-ready QA
2026-04-01 19:41:56 +02:00
- `/docs/howto-gitea-required-checks.md`
- Gitea-Workflow fuer `qa-required` vorbereiten (Phase 1 enforcement-ready).
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
- `/docs/howto-dokumentation-erweitern.md`
- Regeln fuer konsistente, wachsende Doku.
major update
2026-03-04 15:56:58 +01:00
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
## Explanation
major update
2026-03-04 15:56:58 +01:00
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
- `/docs/explanation-architektur.md`
- Architektur-Kompass mit verbindlichen Leitplanken.
- `/docs/explanation-di-container.md`
- Wie der AppContainer funktioniert und neue Services registriert werden.
- `/docs/explanation-sicherheitsmodell.md`
- Vollstaendiges Sicherheitsmodell (Auth, Permission, Scope).
docs: add session management explanation and update rate limiting docs New explanation page covers full session lifecycle: idle/absolute timeouts, remember-token mechanics, frontend keepalive, and cookie attributes. Updates rate limiting docs with remember-token limits and smoke test. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-14 15:57:44 +01:00
- `/docs/explanation-session-management.md`
- Session-Lifecycle, Timeouts, Remember-Token, Frontend-Keepalive.
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
- `/docs/explanation-einstellungen-speicherung.md`
- Warum Settings in DB + Datei-Cache koexistieren.
- `/docs/explanation-docker-betrieb.md`
- Uebersicht und Entscheidungshilfe fuer Dev/Prod.
agent foundation
2026-03-06 00:44:52 +01:00
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
## Reference
agent foundation
2026-03-06 00:44:52 +01:00
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
- `/docs/reference-domain-glossar.md`
- Zentrale Begriffe (Tenant, Role, Permission, Scope, Policy).
- `/docs/reference-api.md`
- API-Referenz-Einstieg.
- `/docs/reference-konfiguration.md`
- ENV-Variablen und Produktions-Defaults.
- `/docs/reference-konventionen.md`
- Projektweite Konventionen (kurz und verbindlich).
refactor: rename lib/ to core/ for clearer core-module separation Rename the top-level lib/ directory to core/ so the project root immediately communicates which code is core platform and which lives in modules/. PHP namespaces (MintyPHP\*) are unchanged — only the Composer PSR-4 path mapping moves from lib/ to core/. Module-internal lib/ directories (modules/*/lib/) are untouched. Updated across the full stack: - composer.json PSR-4 mapping - bootstrap entry points (web/index.php, bin/*, tests/bootstrap.php) - tooling configs (phpstan.neon, phpunit.xml, php-cs-fixer) - 26 architecture contract tests - enforcement-policy, guard-catalog, quality-gates - all documentation (CLAUDE.md, README, 25 docs/, .agents/skills/) - bin/qa-extended.sh search paths - .claude/settings.local.json permission paths Workflow: .agents/runs/CORE-LIB-RENAME-001/ (Analyst → Planner → Executor → Code Review (4 findings fixed) → Security Review → Acceptance Test → Finalizer) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-13 23:20:05 +02:00
- `/docs/reference-core-standards.md`
- Regeln speziell fuer `core/**`.
docs: restructure docs to diataxis and finalize DOCS-RESTRUCTURE-001
2026-03-06 12:25:18 +01:00
- `/docs/reference-benutzer-lifecycle-policy.md`
- Policy- und Laufzeitreferenz fuer User Lifecycle.
- `/docs/reference-frontend-css.md`
- CSS-Schichtsystem und Namenskonventionen.
- `/docs/reference-frontend-javascript.md`
- JS-Module, DOM-Utilities und Patterns.
- `/docs/reference-entwickler-checkliste.md`
- Definition of Done vor Merge.
- `/docs/reference-codex-prompts.md`
- Standard-Prompts fuer Skill-basierte Planung und Implementierung.
fix broken doc links
2026-03-09 18:30:52 +01:00
- `/docs/reference-extension-readiness.md`
feat: extend module platform with UI slots, runtime components, CLI tooling and {{userId}} search support Completes the generic module platform that enables modules to contribute UI elements, runtime JS components, and search resources without any core hardcoding. New generic UI slot types: - topbar.right_item: module-contributed topbar buttons - layout.body_end_template: module-contributed dialog/overlay templates - layout.head_style: module-contributed global CSS - runtime.component: declarative JS component registration with phase ordering New infrastructure: - ModuleAutoloader: PSR-4 autoloading for module-local PHP classes - ModuleRuntimePageBuilder: symlinks module pages into runtime directory - ModuleRuntimeAssetPublisher: publishes module CSS/JS to web/modules/ - ModulePermissionSynchronizer: syncs module permissions to DB - CLI scripts: module-runtime-sync, module-build, module-migrate, module-permissions-sync, module-assets-sync - {{userId}} placeholder in SearchDataService for user-scoped search queries - Component runtime with phased initialization (early/default/late) - AppContainer.protectExistingBindings() to prevent module→core overwrites - Architecture tests: ModuleStructureContractTest, CoreTemplateIsolationTest, FrontendComponentRuntimeContractTest, AppContainerIsolationContractTest Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-18 22:19:56 +01:00
- Freigabe-Checkliste fuer weitere Module auf Basis des bestehenden Modul-Contracts.
docs: add CLI command reference and update key docs to use bin/console New docs/reference-cli-commands.md covers all commands, bootstrap helpers, and how to add new commands. Updated lokale-entwicklung, entwickler-checkliste, betriebscheck-doctor, index, and web/index.php error message to reference bin/console instead of legacy bin/*.php scripts. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 19:25:38 +01:00
- `/docs/reference-cli-commands.md`
- Alle CLI-Kommandos (`php bin/console`), Bootstrap-Helfer, Anleitung neue Kommandos.
feat: extend module platform with UI slots, runtime components, CLI tooling and {{userId}} search support Completes the generic module platform that enables modules to contribute UI elements, runtime JS components, and search resources without any core hardcoding. New generic UI slot types: - topbar.right_item: module-contributed topbar buttons - layout.body_end_template: module-contributed dialog/overlay templates - layout.head_style: module-contributed global CSS - runtime.component: declarative JS component registration with phase ordering New infrastructure: - ModuleAutoloader: PSR-4 autoloading for module-local PHP classes - ModuleRuntimePageBuilder: symlinks module pages into runtime directory - ModuleRuntimeAssetPublisher: publishes module CSS/JS to web/modules/ - ModulePermissionSynchronizer: syncs module permissions to DB - CLI scripts: module-runtime-sync, module-build, module-migrate, module-permissions-sync, module-assets-sync - {{userId}} placeholder in SearchDataService for user-scoped search queries - Component runtime with phased initialization (early/default/late) - AppContainer.protectExistingBindings() to prevent module→core overwrites - Architecture tests: ModuleStructureContractTest, CoreTemplateIsolationTest, FrontendComponentRuntimeContractTest, AppContainerIsolationContractTest Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-18 22:19:56 +01:00
- `/docs/reference-module-manifest-contract.md`
- Verbindlicher Runtime- und Manifest-Contract fuer Module (V1.1).
chore: snapshot notifications hardening and css/docs alignment
2026-03-20 00:05:03 +01:00
- `/docs/reference-notifications-module.md`
- Verbindliche Referenz fuer Notifications (Events, Guardrails, Dedupe, Bell-Vertrag, Tests).
docs: add CLI command reference and update key docs to use bin/console New docs/reference-cli-commands.md covers all commands, bootstrap helpers, and how to add new commands. Updated lokale-entwicklung, entwickler-checkliste, betriebscheck-doctor, index, and web/index.php error message to reference bin/console instead of legacy bin/*.php scripts. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 19:25:38 +01:00
- Agent-Workflow (Rollen, State-Machine, Contracts): siehe `/.agents/workflow.md`
Reference in New Issue Copy Permalink