Files
breadcrumb-the-shire/docs/tutorial-02-systemueberblick.md
fs 0e86925464 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:42 +02:00

43 lines
1.1 KiB
Markdown

# Systemüberblick
Letzte Aktualisierung: 2026-03-06
## Ziel
In 10 Minuten verstehen, was die Software tut, wie sie aufgebaut ist und welche Kernprinzipien immer gelten.
## Was ist CoreCore?
CoreCore ist eine mandantenfähige Admin-Software mit klarer Rollen-/Rechtestruktur.
Kernmodule:
- Mandanten, Abteilungen, Benutzer, Rollen, Berechtigungen
- Adressbuch und globale Suche
- API (`/api/v1`)
- Scheduler (geplante Aufgaben)
- Optional Microsoft-SSO
## Kernprinzipien
- Multi-Tenant by default: Daten und Sichtbarkeit sind tenant-gebunden.
- Security first: Auth, Permission und Tenant-Scope sind Pflicht, nicht optional.
- Schichtentrennung: `pages` -> `Service` -> `Repository`.
- API-Verträge sind UUID-first.
## Projektkarte
- `config/` Konfiguration
- `db/` Schema/Updates
- `core/` Fachlogik
- `pages/` Actions + Views
- `templates/` Partials/Layout
- `web/` CSS/JS/Assets
- `docs/` Entwicklerdokumentation
## Danach
1. Setup und erster Login: `/docs/tutorial-03-setup-und-erster-login.md`
2. Begriffe sicher verstehen: `/docs/reference-domain-glossar.md`
3. Architekturfluss verinnerlichen: `/docs/tutorial-04-architektur-request-flow.md`