# NEXARCH

Modulares Dokumentenmanagement- und Office-System. Siehe `CLAUDE.md` für
Arbeitsregeln (Datenschutz, Secrets) und die Konzeptdokumente unten für die
fachliche Gesamtübersicht.

## Dokumentenlandkarte

**Root-Ebene — Konzeptdokumente (projektweit):**

| Datei | Inhalt |
|---|---|
| `PRODUKTARCHITEKTUR.md` | Gesamtübersicht über Module, Schnittstellen, Deployment |
| `SICHERHEITSKONZEPT.md` | Sicherheitsarchitektur, Bedrohungsmodell |
| `MIGRATIONSKONZEPT.md` | Übernahme aus Altsystemen (archivdms, archivmail) |
| `SKALIERUNGSKONZEPT.md` | Mandantenfähigkeit, Skalierungsstrategie |
| `STORAGE-KONZEPT.md` | Speicher-/Ablagearchitektur |
| `SAAS-BETRIEBSMODELL.md` | Betriebsmodell für den SaaS-Betrieb |
| `UI-UX-KONZEPT.md` | Design-System- und UX-Leitlinien |
| `CLAUDE.md` | Arbeitsregeln für KI-gestützte Entwicklung in diesem Repo |

**Module (je eigenes Kanban-Board + Code-Verzeichnis):**

| Board | Code | Modul |
|---|---|---|
| `core-kanban/` | `internal/`, `cmd/` | Identität, Mandanten, Rechte, API-Grundgerüst |
| `dms-kanban/` | `dms/` | Dokumentenmanagement (siehe `dms/README.md` für Referenzprojekte) |
| `mail-kanban/` | `mail/` | Postfach-Modul |
| `workflow-kanban/` | `workflow/` | Aufgaben, Freigaben, Routing |
| `ai-kanban/` | `ai/` | KI-Funktionen (Zusammenfassung, Extraktion, Suche) |
| `connect-kanban/` | `connect/` | Externe Systemanbindungen (ERP, DATEV, CRM) |
| `archive-kanban/` | `archive/` | Archivierung, Retention, Kennzahlen |
| `migration-kanban/` | `migrations/` | Datenübernahme aus Altsystemen |

Jedes Board hat `README.md` (Modulübersicht) und `DEVLOG.md` (Session-Log).
Ticket-Dateien liegen unter `<board>/tickets/<CODE>.md`, Bearbeitungsstand in
`<board>/board.csv`/`board.json`.

**Prüfprotokolle:**

- `docs/` — Core-Prüfprotokolle (`<CODE>-PRUEFPROTOKOLL.md`) sowie einige
  projektweite Betriebsdokumente (Teststrategie, Coding-Guidelines, Incident
  Response, Rollout-131)
- `<modul>/docs/` (z. B. `dms/docs/`, `ai/docs/`) — Prüfprotokolle des
  jeweiligen Moduls

**Gemeinsames Frontend-Design-System:** `web/shl/` (`@nexarch/shl`), von
allen `web/<modul>/`-Apps importiert.

## Setup

Jedes Modul hat ein eigenes `README.md` mit Setup-Anleitung (z. B.
`dms/README.md`, `cmd/`/`internal/` für Core).