# 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
- `lib/` 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`