Medidentas Digital — Dokumentation (Landkarte)
Einstieg in die docs/ von Medidentas Digital (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.
🧭 Entwicklungsansatz auf einen Blick: Wie True North, die Leitprinzipien G-1…G-8 und der Way-of-Working zusammenspielen, stellt
konventionen/Entwicklungsansatz.mdexplizit und übersichtlich dar — der beste Einstieg ins Warum & Wie.
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–R13, Use-Cases UC-1..8, Datenmodell §4, Lifecycle §5, offene Punkte §11). | Die maßgebliche Fachquelle — bei jeder fachlichen Frage. |
fachlich/Feature-Liste.md | Lebende Feature-Liste — was ist tatsächlich gebaut (✅/🟡/⛔), je Modul/True-North, mit Zugang + Version. | Für "was kann die App heute?" — je PR gepflegt. |
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. |
fachlich/Anforderungen-Meeting-2026-07-12.md | Anforderungsquelle aus dem Abstimmungstermin 12.07.2026 (anonymisiert): Themen M1–M20, Action-Items A1–A10, Mapping auf Module/OP. | Bestätigungen zum Stand 0.72.0 + neue Festlegungen (Flat-Fee, Dexman-Portal, Baumstruktur); Bezug MED-D-108. |
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/Prozessmodell.md | Prozessmodell — wie Medidentas die Geschäftsprozesse abbildet & unterstützt (autoritative Achsen-Landkarte: Lifecycle-Status vs. Auftrag-Status je Beratungsauftrag; Onboarding-Teilschritt als Detail innerhalb der Lifecycle-Stufe onboarding (die vormalige Prozessphase-Achse ist mit MED-D-151 abgelöst); Dokumente & Unterschriften als quer-liegende Achse; Fahrplan P1–P5). | MED-D-79, G-3, G-4, OP-DOCS-1 |
architektur/Beratungsauftraege.md | Beratungsaufträge — das 3-Ebenen-Modell (Person · Beratungsauftrag · Artefakte): Produkt-Katalog (Dentmarking-Gutachten · Versicherungsoptimierung · Praxisfinanzierung · Kapitalanlage · Dexman vorbereitet), Auftrags-Status je Produkt, Slices A–C2a. | MED-D-95, MED-OP-AUFTRAG-1, G-8 |
architektur/Weltmodell-Data-Dictionary.md | Weltmodell / Data Dictionary — kanonischer Katalog der Entitäten & Wertobjekte (eine Definition, überall gleich strukturiert); erstes Wertobjekt Anschrift (strasse·plz·ort), Governance + Angleichungs-Backlog. | MED-D-85, G-8, G-2, G-3 |
architektur/Architektur-Uebersicht.md | Grobe Systemstruktur (Mermaid, technische Laufzeit-Topologie: Worker · D1 · R2 · NextCloud · Signatur · CRM) + SBOM-Fundstelle (CycloneDX-CI-Job). | G-2, G-4 |
architektur/Akte-Struktur.md | Mandant-Struktur (UC-6): Vollbild-3-Spalten-Cockpit (Person-Rail · 6 arbeits-gegliederte Register · Kontext-Rail) + strukturiertes Aktenreife-Modell (domain/aktenreife.ts, Lifecycle-stufen-zugeordnet). | D-41, MED-D-156, G-2, G-3, OP-AKTE-1 |
architektur/Akten-Cockpit-Redesign.md | Akten-Cockpit-Redesign — Programm & Slice-Plan (Handoff "Akten-Cockpit 1a (Detail)"): Ziel-IA (5 Reiter + 4 Overlays, Basis-Informationen default), 10 neue Komponenten, Slices S1-S6 (IA-Fundament · Dokument-Zustandsmaschine · 1:n-Bankkonten · VersionedField/Self-Service · Unterschriften-Assistent · Feinschliff). | MED-D-188, MED-OP-AKTE-2, OP-SIGN-1 |
architektur/Dokumentenverwaltung-NextCloud.md | Dokumente in NextCloud: WebDAV/OCS, Ablagestruktur, Referenz-Modell. | A-1, OP-DOC-1 |
architektur/Fremdformulare.md | Fremdformular-Feldmapping & Prefill (AD-010, Weg A): opake AcroForm-Felder fremder PDFs (Bank-/Partner-Formulare) je Feld einem Weltmodell-Attribut zuordnen (G-8) + aus Stammdaten vorbefüllen; Füllen pdf-lib/Signieren DocuSign (G-1). Slices (Slice 1 gebaut, Rücklauf = Slice 2). | AD-010, MED-D-235, MED-OP-FORM-5, G-1, G-8 |
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/Kosten.md | Betriebskosten automatisch ziehen (cost-pull-at-source, G-7): Infra-/LLM-/Cloud-Kosten je Provider-API pullen (Cron + on-demand), Datenmodell, Rollen, Slices — abgeleitete Sicht in Cent, nie doppelt persistiert. | G-7, MED-OP-COST-1/2, MED-D-62 |
architektur/Erweiterbarkeit-Spezialtools.md | Erweiterbarkeit: Tool-Host (R10), Manifest-Vertrag, Isolation, Lebenszyklus. | A-6, OP-EXT-1 |
architektur/In-App-Assistent.md | In-App-Chatbot (drkv-Standard-Baustein): LLM + RAG auf Live-Daten & Doku (Doku-Q&A · Insights · Feedback), vorschlagend, RBAC/PII-sicher — löst "Medidentas-GPT" ein. | OP-ASSIST-1, MED-D-74 |
architektur/Kunden-Self-Service-Portal.md | Kunden-Self-Service-Portal — persistentes Kunden-Login: Kunde pflegt Infos selbst, submitted≠actual, 4-Augen-Freigabe (reuse feld-sichtung/uebernahme); passwortlos/Magic-Link, Reuse-Map, Compliance (Zero-Trust/DSGVO), Slice-Plan S0–S5. | MED-D-279, MED-OP-PORTAL-1, G-1, G-2, RISK-33 |
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 |
spezialtools/Dexman-Fachmodell.md | Dexman-Fachmodell & Datenübernahme — Lastenheft aus der Excel-Analyse (DexMan v41 · Personal Manager v2 · Darlehensübersicht v25): Personal/Umsatzbeteiligung, Darlehensspiegel (geschäftlich/privat), Liquiditätsvorschau, Mindestumsatz, Inventar/AfA; anonymisierte Beispieldaten (dexman-beispieldaten/). | DEX-8..13, OP-DEX-6..9 |
spezialtools/Dentmarking.md | Dentmarking — Detail-Lastenheft: Fragebogen-basiertes Betriebskennzahlen-Gutachten (Kennzahlen vs. Benchmark, Potential, Befunde), Vorstufe/Lead-Einstieg zu Dexman. | DM-n, OP-DENTMARK-1, R10 |
spezialtools/Dentmarking-Excel-Logik.md | Dentmarking — extrahierte Excel-Logik (Referenz Neuimplementierung): Feldkatalog, 18 Kennzahl-Formeln, Benchmarks, Potentialrechnung, VBA-Abläufe, Befunde B-1..B-11. | DM-n, OP-DM-1/2 |
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/Test-Uebersicht.md | Lebende Test-Übersicht — welche automatischen Tests (Server-Vitest, Client-Build, Doku-Checks) sichern was ab; CI-Pipeline. | Qualität — je PR gepflegt |
betrieb/Decision-Log.md | Decision Log (D-n) — chronologisches Entscheidungsprotokoll (ADR-artig): was wurde warum entschieden. | Audit-Trail — je PR gepflegt |
betrieb/Kunden-Besprechungspunkte.md | Lebende Liste offener Punkte, die mit dem Kunden zu klären/bestätigen sind (KB-n), bevor die Umsetzung final gebaut wird. | Kundenabstimmung — je PR gepflegt |
betrieb/Timesheet.md | Arbeitszeit-Timesheet (Start/Stop je Session, Gap-Regel, Methodik). | Way-of-Working |
konventionen/ — Way-of-Working
| Datei | Inhalt |
|---|---|
konventionen/Entwicklungsansatz.md | Entwicklungsansatz auf einen Blick — True North (3 Leitfragen), Leitprinzipien G-1…G-8, Way-of-Working (Everything-as-Code, Audit-Trail, ID-System, Branch-first/Draft-PR, SemVer), Standard-Prozess, Compliance-Haltung. Lesbare Übersicht; verbindlich bleibt CLAUDE.md. |
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/Management-Summary.md | Management Summary — Ziel · Arbeitsweise · Fortschritt · aktueller Status · nächste Schritte auf einen Blick (Business/Management, pyramidal). |
produkt/Produkt-und-Marketing.md | Nicht-technisch: Nutzenversprechen, Zielgruppe, Abgrenzung. |
produkt/Design-Entscheidungen-Akte.md | Design-Entscheidungen des Mandanten (AD-001…AD-015) — das Warum hinter dem Akten-Cockpit-Redesign, je Entscheidung mit Umsetzung im Repo (MED-D-ID · Status). Eingearbeitet aus dem claude.ai/design-Handoff. |
design/akten-cockpit-handoff/ | Design-Handoff-Archiv (Quelle der Wahrheit, eingefroren) — akte-patterns.md (verbindliche Maße/Tokens), .dc.html (Pixel-Prototyp), screenshots/01–17 (Soll-Zustände), design-decisions.md. Pixel-Abnahme-Referenz fürs Akten-Cockpit. |
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.