Medidentas — Dokumentation (Landkarte)
Einstieg in die docs/ von Medidentas (Plattform für Kunden-Lebenszyklus & Beratungsdokumentation).
Das Repo ist die einzige Quelle der Wahrheit (Everything-as-Code) — diese Seite ordnet die Dokumente
nach Zweck. Die Dateien sind physisch in thematische Unterordner gegliedert (fachlich/ ·
architektur/ · betrieb/ · konventionen/ · glossar/ · zielgruppen/ · produkt/), die
Docusaurus-Sidebar spiegelt diese Gruppen (_category_.json je Ordner).
True North — jede Doku/jedes Feature muss ≥1 dieser drei Leitfragen direkter, schneller oder genauer beantworten: (1) Wo steht der Kunde im Prozess? (2) Was ist offen und fällig? (3) Ist alles vollständig & rechtssicher dokumentiert? Lebende Prüfliste:
betrieb/Sanity-Checkliste.md.
Wo anfangen (Session-Start-Reihenfolge)
Verbindliche Lese-Reihenfolge für jede neue Session (Quelle:
konventionen/agents.md §4, Root-CLAUDE.md):
HANDOFF.md— kompakter Gesamtstand + offene Punkte (§4)fachlich/Lastenheft.md— fachliche Master-Speckonventionen/agents.md— Way-of-Working / Konventionen
fachlich/ — Fachliche Spezifikation (das „Was")
| Datei | Inhalt | Wann lesen |
|---|---|---|
fachlich/Lastenheft.md | Master-Spec (Module R1–R12, Use-Cases UC-1..8, Datenmodell §4, Lifecycle §5, offene Punkte §11). | Die maßgebliche Fachquelle — bei jeder fachlichen Frage. |
fachlich/MVP-Scope.md | MVP-Scope & Slice-Plan — Weg zu 1.0.0: vertikale Slices, priorisiertes Backlog, Akzeptanzkriterien (Slice 1 = Mandant + Onboarding). | Für die Umsetzungs-Reihenfolge / „was bauen wir als Nächstes". |
fachlich/Anforderungen-Workshop-2026-01-20.md | Anforderungsquelle aus dem Prozess-Workshop (anonymisiert): Themen W1–W10, Mapping auf Module/UC/OP. | Für das „Warum" hinter R11/R12, UC-7/8 und den geschärften OPs. |
architektur/ — Architektur-Design (das „Wie, geplant")
| Datei | Inhalt | Bezug |
|---|---|---|
architektur/System-Charakter.md | Was für eine Anwendung ist Medidentas? Anwendungs-Archetyp (Case-Management + Orchestrierung), eigengebauter Kern, „System of Engagement, nicht of Data", Schichten-Modell. | G-1, G-2, G-4 |
architektur/Dokumentenverwaltung-NextCloud.md | Dokumente in NextCloud: WebDAV/OCS, Ablagestruktur, Referenz-Modell. | A-1, OP-DOC-1 |
architektur/Unterschriften.md | E-Signatur: DocuSign vs. PandaDoc, eIDAS-Niveaus, Provider-Abstraktion. | A-2, OP-SIGN-1 |
architektur/Audit-Log.md | Lückenlose Doku: Event-Modell, „nicht reverse-engineerbar", Retention. | G-4, OP-AUDIT-1 |
architektur/Stack.md | Technologie-Stack: Optionen, Empfehlung, Standardwerkzeug-Bias. | A-4, OP-STACK-1 |
architektur/Deploy.md | Deploy-Runbook: Subdomain app.medidentas.com, Worker + Static Assets, D1-Anlage, Cloudflare Access, CI-Deploy. | OP-DEPLOY-1 |
architektur/Erweiterbarkeit-Spezialtools.md | Erweiterbarkeit: Tool-Host (R10), Manifest-Vertrag, Isolation, Lebenszyklus. | A-6, OP-EXT-1 |
architektur/Meeting-Doku-und-Aufgaben.md | Meeting-Doku & Aufgaben („Meeting Minutes"): Fluss Transkription→Protokoll→Aufgaben→Wiedervorlage/Cockpit, Tool-Anbindung, Compliance. | R11, A-8, OP-MEET-1 |
spezialtools/ — Spezial-Tools (zubuchbare Fach-Fähigkeiten)
| Datei | Inhalt | Bezug |
|---|---|---|
spezialtools/Dexman.md | Dexman — Detail-Lastenheft: Praxis-Rentabilität, Umsatzprognose, Behandler-Feedback; Wettbewerbsanalyse medipulse.de. | DEX-n, R10 |
betrieb/ — Betrieb · Compliance · Governance
| Datei | Inhalt | Bezug |
|---|---|---|
betrieb/Compliance.md | Datenschutz (DSGVO/revDSG), eIDAS/ZertES, Aufbewahrung, Compliance-Tracker (DE/AT/CH). | OP-DSGVO-1 |
betrieb/Risikoregister.md | Risikoregister (RISK-n) — regelmäßig sichten/pflegen. | Risiko |
betrieb/Sanity-Checkliste.md | True-North-Prüfliste (Top-3-Leitfragen) mit Status ✅/🟡/⛔. | True North |
betrieb/Timesheet.md | Arbeitszeit-Timesheet (Start/Stop je Session, Gap-Regel, Methodik). | Way-of-Working |
konventionen/ — Way-of-Working
| Datei | Inhalt |
|---|---|
konventionen/agents.md | Verbindliche Konventionen für KI-/Coding-Agenten: ID-System, Doku-Format, Branch-/Push-Regeln, Audit-Trail. |
glossar/ · zielgruppen/ · produkt/
| Datei | Inhalt |
|---|---|
glossar/Glossar.md | Glossar (generiert) — speist die Begriffs-Sprechblasen in der Doku. Quelle: docs-site/src/glossar/glossar.mjs. |
zielgruppen/Lesepfade.md | Lesepfade nach Zielgruppe (Anwender · Fach/Management · IT-Arch/Dev · IT-Ops). |
produkt/Produkt-und-Marketing.md | Nicht-technisch: Nutzenversprechen, Zielgruppe, Abgrenzung. |
Dokumente außerhalb von docs/ (Repo-Root)
| Datei | Inhalt |
|---|---|
HANDOFF.md | Kompakter Gesamtstand + offene Punkte — zuerst lesen. |
CLAUDE.md | Gebündelte Leitplanke / Guiding Principles (Kurzfassung, verweist hierher). |
CHANGELOG.md | Audit-Trail je PR (Datum · PR-Link · Entscheidungen), neueste zuerst. |
README.md | Projekt-Überblick, Quick-Start, Doku-Site. |
ID-System (Commits referenzieren IDs): G-n global · R-n Module · Rn-F## Felder · A-n Architektur
· S-n Vereinfachungen · OP-<Thema>-n offene Punkte · UC-x · FR-n. Details:
konventionen/agents.md §3.
Diese Landkarte ist der Einstieg beim Browsen von
docs/(GitHub) und die Startseite der Doku-Site. Neue Dokumente in den passenden Unterordner legen und hier eintragen (in eigenem Ordner ein_category_.jsonmitlabel+positionergänzen), damit Übersicht und Sidebar aktuell bleiben.