docs: Root-README als Dokumentenlandkarte, toten Verweis in CLAUDE.md gefixt
CI / Web-Barrierefreiheitspruefung (axe, Tastatur, Reflow, Textabstaende) (push) Canceled after 0s
CI / Web-Barrierefreiheitspruefung (axe, Tastatur, Reflow, Textabstaende) (pull_request) Canceled after 0s
CI / DMS Security-Test-Gate (AC5, Merge-Gate) (push) Canceled after 0s
CI / Core-Modul (Build/Vet/Test) (push) Canceled after 0s
CI / Connect Security-Test-Gate (QA-01 AC4, Merge-Gate) (push) Canceled after 0s
CI / DMS-Modul Supply-Chain-Scan (govulncheck) (push) Canceled after 0s
CI / Web (dms-browser) (push) Canceled after 0s
CI / Web (pdf-viewer) (push) Canceled after 0s
CI / Web (shl) (push) Canceled after 0s
CI / Web (dms-browser) (pull_request) Canceled after 0s
CI / Core-Modul (Build/Vet/Test) (pull_request) Canceled after 0s
CI / DMS Security-Test-Gate (AC5, Merge-Gate) (pull_request) Canceled after 0s
CI / Connect Security-Test-Gate (QA-01 AC4, Merge-Gate) (pull_request) Canceled after 0s
CI / DMS-Modul Supply-Chain-Scan (govulncheck) (pull_request) Canceled after 0s
CI / Web (pdf-viewer) (pull_request) Canceled after 0s
CI / Web (shl) (pull_request) Canceled after 0s
Core-Schnittstellen-Vertragstests / contract-tests (pull_request) Canceled after 0s
Supply-Chain-Scan (Go) / govulncheck (pull_request) Canceled after 0s
Supply-Chain-Scan (npm) / npm-audit (pull_request) Canceled after 0s
Core-Pflichttest-Gate / pflichttest-gate (pull_request) Canceled after 0s
RBAC-Rollenhierarchie-Pflichtgate / rbac-policy-invariant (pull_request) Canceled after 0s
CI / DMS-Modul (Lint/Build/Test/Coverage/Artefakt) (push) Canceled after 0s
CI / DMS-Modul (Lint/Build/Test/Coverage/Artefakt) (pull_request) Canceled after 0s

Fable-5.1-Strukturreview (MD-Dateien) fand: kein Root-README/Index, daher
niemand findet die Doku-Ebenen (Root-Konzepte -> 8 Boards -> Modul-docs/ ->
docs/). CLAUDE.md verwies auf datenmodell-altsysteme.md, das nirgends im
Repo existiert - auf die vorhandenen known-issues-archivdms/archivmail.md
umgebogen.

Zurueckgestellt bis Nutzerentscheidung (Fable5 hatte dafuer offene Fragen
gestellt): docs/ in core/docs umbenennen, dms-kanban-Sonderdateien
(reuse-mapping.md, known-issues-*.md) verschieben, docs/cut-01/ auslagern,
code*/-Worktrees gitignoren.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
patrickandClaude Sonnet 5 committed 2026-10-19 03:19:03 +02:00
1 parent 0370e0e88f
commit 243622013f
2 files changed
+54 -1

No files matched your search

+1 -1
View File
@@ -4,7 +4,7 @@ Siehe `PRODUKTARCHITEKTUR.md` für die Gesamtübersicht sowie die weiteren Konze
## Datenschutz (DSGVO) ## Datenschutz (DSGVO)
- **Keine echten Kunden-/Mandantendaten in Prompts, Testfixtures oder Screenshots** — je nach Zielsystem (siehe `datenmodell-altsysteme.md`) potenziell personenbezogene oder besondere Kategorien von Daten (Art. 9 DSGVO). - **Keine echten Kunden-/Mandantendaten in Prompts, Testfixtures oder Screenshots** — je nach Zielsystem (siehe `dms-kanban/known-issues-archivdms.md`, `dms-kanban/known-issues-archivmail.md`) potenziell personenbezogene oder besondere Kategorien von Daten (Art. 9 DSGVO).
- Test-/Demodaten synthetisch halten, nie einen Export aus einem echten Kunden-/Altsystem als Fixture verwenden. - Test-/Demodaten synthetisch halten, nie einen Export aus einem echten Kunden-/Altsystem als Fixture verwenden.
- Secrets (API-Keys, DB-Credentials, Verschlüsselungs-Keys) nie in Prompts einfügen. - Secrets (API-Keys, DB-Credentials, Verschlüsselungs-Keys) nie in Prompts einfügen.
- Claude Code hier ausschließlich für Code-/Konzeptarbeit; für Auswertungen an echten Kundendaten (z. B. Migrationstests gegen Altsysteme) lokale Ollama-Server nutzen, nicht Claude. - Claude Code hier ausschließlich für Code-/Konzeptarbeit; für Auswertungen an echten Kundendaten (z. B. Migrationstests gegen Altsysteme) lokale Ollama-Server nutzen, nicht Claude.
+53
View File
@@ -0,0 +1,53 @@
# 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).