Taktano — Dokumentation (Landkarte)
Einstieg in die docs/ von Taktano (Werkstatt-Betriebssystem für Fahrzeug-Veredelung).
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
(zielgruppen/ · anwender/ · fachlich/ · architektur/ · betrieb/ · konventionen/ · produkt/ · glossar/),
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) Wie hoch ist die Auslastung? (2) Wo stehen die Fahrzeuge (physisch und in der Bearbeitung)? (3) Wann sind die nächsten freien Kapazitäten? Lebende Prüfliste:
betrieb/Sanity-Checkliste.md.
Nach Rolle einsteigen · Begriffe nachschlagen
| Datei | Inhalt |
|---|---|
zielgruppen/Lesepfade.md | Lesepfade nach Zielgruppe — kuratierte Einstiege für Anwender · Fach/Management · IT-Arch & -Dev · IT-Operations (verlinkt die bestehenden Docs, OP-DOCS-4). |
glossar/Glossar.md | Glossar (inkl. CP-SAT) — zentrale Begriffsklärung, klassifiziert nach Art (fachlich/technisch) × Ebene (Grundprinzip/erweitert) und auf der Doku-Site filterbar; speist zugleich die Begriffs-Sprechblasen (Mouse-over/Klick) in der gesamten Doku. Gepflegt in docs-site/src/glossar/glossar.mjs, generiert (OP-DOCS-10). |
Begriffs-Sprechblasen: Auf der Doku-Site sind Fachbegriffe dezent unterstrichen — Mouse-over oder Klick zeigt die Kurz-Erklärung aus dem Glossar.
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
Lesepfade
Kuratierte Einstiege — nach Rolle und nach Aufgabe — stehen gebündelt an einer Stelle:
zielgruppen/Lesepfade.md, der menschlichen Vordertür der Doku. (Diese
Landkarte bleibt der vollständige Datei-Index nach Ordner unten.)
anwender/ — Anwender-Handbuch (Werkstatt-Team)
| Datei | Inhalt | Wann lesen |
|---|---|---|
anwender/Handbuch.md | Erste Schritte — Bereiche der App, Werker-Modus, Status-Wörter, die drei Leitfragen; in Werkstattsprache, ohne Fachchinesisch (OP-DOCS-14 E1). | Erster Einstieg für jedes neue Team-Mitglied. |
anwender/Mein-Arbeitstag.md | Mein Arbeitstag — „Meine Arbeit" bedienen: Name wählen, ⏸/▶/✓, Doku-Fenster, Textbausteine, Pflicht-Fotos, Offline-Warteschlange. | Für Werker am Terminal. |
anwender/Klaerfall-melden.md | Klärfall melden & lösen — melden in 3 Schritten, die vier Lösungs-Wege, Klärung einplanen. | Wenn etwas klemmt. |
anwender/Fahrzeug-annehmen.md | Fahrzeug annehmen — Auftrag anlegen („Ein Satz genügt"), Check-in „🚗 Fahrzeug da" mit Car-Check + FIN. | Für die Annahme. |
fachlich/ — Fachliche Spezifikation (das „Was")
| Datei | Inhalt | Wann lesen |
|---|---|---|
fachlich/Lastenheft.md | Master-Spec (Module R1–R9, IDs, Mermaid, Datenmodell §4.9, Lifecycle §5.1, Optimierungsziel §6.2). | Die maßgebliche Fachquelle — bei jeder fachlichen Frage. |
fachlich/datamodel.md | Datenmodell des Scheduler-Slice (Stammdaten = Solver-Eingabe). | Wenn du die Solver-Eingangsdaten verstehen willst. |
fachlich/operativmodell.md | Operatives Modell: Auftrag (R7) + Teilschritt-Instanz, Lifecycle (S-6), Reservierung. | Für den laufenden Auftrags-/Bearbeitungs-Zustand. |
fachlich/solver.md | Globaler Optimierer (A-3/A-5): CP-SAT-Service + TS-Fallback, Ziel-/Reihenfolge-Suche. | Für die Taktung/Reihenfolge-Optimierung (Herz des Systems). |
fachlich/Flow-Analyse.md | Befund zum Auftrags-Flow (Reservierung → … → Abholung): Lifecycle vs. fachliche Phase. | Hintergrund/Begründung zum Phasen-Modell (OP-R3-1). |
fachlich/Flow-Refactor-Plan.md | Umsetzungsplan „Phasen first-class" (OP-R3-1), inkrementelle PRs. | Hintergrund zur Flow-Refaktorierung (größtenteils umgesetzt). |
architektur/ — Architektur-Design je offenem Punkt (das „Wie, geplant/im Bau")
| Datei | Inhalt | Bezug |
|---|---|---|
architektur/Architektur-Uebersicht.md | Grobe Systemstruktur (Mermaid) + SBOM-Fundstelle: Client · Worker/DO · Solver-Service · D1/DO-SQLite · OTel. | OP-SBOM-1 |
architektur/Audit-Log.md | Audit-Log / Änderungshistorie: D1 (EU), Event-Modell, „nicht reverse-engineerbar", Retention. | OP-AUDIT-1 |
architektur/Notfall-Alert.md | Notfall-/Schaden-Alert: Klärfall-Variante mit Hard-Stop + erzwungener Eskalation + Fahrzeug-Sperre; „eskalieren statt verschlimmbessern". | OP-ALERT-1 |
architektur/Observability.md | Observability/Logging-Backend: OTel/OTLP-Kandidaten (Grafana/Sentry/CF-nativ/Honeycomb), DSGVO-Residenz, Empfehlung; Abgrenzung zu Cockpit/Kosten/Audit. | OP-OBS-1 |
architektur/Kosten.md | Kosten-Dashboard: zwei Sichten (betriebswirtschaftlich / Infra-Spend), Datenmodell, Rollen, Slices. | OP-COST-1 |
architektur/Akademie.md | Skill-Niveau-Progression & Akademie: Ausbildungsziele, XP-Schwellen, begründete Beförderung. | OP-R1-3 |
architektur/In-App-Assistent.md | In-App-Assistent: Doku-Q&A + Feedback + Insights (vorschlagend, nicht ausführend). | OP-AI-4 |
architektur/Billing-Zugang.md | Billing & zahlungs-gesteuerter Zugang (Stufenmodell, fail-open, Audit). | OP-BILLING-1 / OP-ACCESS-1 |
architektur/Bildbewertung.md | Automatische Bildbewertung: Pre-Upload-Gate + Auto-Erkennung (Optionen, EU-Residenz). | OP-QS-2 |
architektur/Persistenz.md | Persistenz-Konvention & Migrations-Hygiene: DO-Blob · DO-SQLite · D1, Drizzle als Single Source + CI-Gate. | OP-DATA-1 / S-SEED-5 |
architektur/Backup-Restore.md | Backup & Restore (Point-in-Time): Snapshot vs. PITR, Restore-Punkt via Audit-Log. | OP-BACKUP-1 |
architektur/Mandantenfaehigkeit.md | Mandantenfähigkeit & Tenant-Isolation: Daten pro Tenant physisch getrennt, Registry zentral. | OP-TENANT |
architektur/Seed-Abloese-Plan.md | Seed-Ablösung aus dem Laufzeitpfad + Tenant-Vorlage + Purge (Admin). | OP-SEED-1 / OP-TENANT |
architektur/Entitaeten-Lebenszyklus.md | Entitäten-Lebenszyklus: CRUD je Entität, Versionierung (Audit), Archiv statt Hard-Delete, Schutz laufender Prozesse. | OP-CRUD-1 |
architektur/Operative-Durchgaengigkeit.md | Operative Durchgängigkeit & Werker-Sicht (Flow-Audit-Folge): durchgängige Auftragszeile („Tafel"), Werker-/Mitarbeiter-Sicht, Annahme-Maske; Slices U1–U3. | OP-UX-1 |
architektur/Doku-und-Kommentare.md | Schritt-Doku & Kommentare: Pflicht-Kommentar · Foto-Mindestanzahl je Perspektive · inhaltlicher Aspekt-Leitfaden (F16); Roadmap Diktat/Textbausteine/Mehrsprachigkeit/KI-Plausibilität. | OP-R4-3 / OP-DIKTAT-1 / OP-TEXTBLOCK-1 |
architektur/Offline-PWA.md | Offline-Fähigkeit als PWA: Service-Worker-Shell + Read-Offline (Stufe B), verzögerter Foto-Upload via persistenter IndexedDB-Queue + Queue-Popover (Stufe C); Ack-getriggerte Registrierung, Idempotenz via deterministischem R2-Key. | OP-OFFLINE-1 |
architektur/Fahrzeug-3D.md | Fahrzeug-3D: CC0-Karosserietyp-Modelle (GLB) + <model-viewer> (drehbar, nummerierte Hotspot-Markierungen mit Kommentar/Foto) + USDZ-Pfad iOS/AR; Markierungs-Datenmodell renderer-neutral. | OP-R6-2 |
betrieb/ — Governance · Compliance
| Datei | Inhalt | Bezug |
|---|---|---|
betrieb/Compliance.md | Compliance, Zertifizierung & Audit-Bereitschaft (TÜV · ISO · Security; DE/AT/CH). | OP-COMPLIANCE-1 |
betrieb/Risikoregister.md | Risikoregister (RISK-n) — regelmäßig sichten/pflegen. | OP-* / Risiko |
betrieb/Sanity-Checkliste.md | True-North-Prüfliste (Top-3-Leitfragen) mit Status ✅/🟡/⛔. | True North |
betrieb/UX-Review-2026-07.md | UX- & Prozess-Review (07/2026) — Urteil „starkes Gesellenstück, noch kein Meisterwerk": Stärken S1–S6, Befunde B1–B7, Empfehlungen E1–E6. | OP-UX-7 |
betrieb/Doku-Review-2026-07.md | Doku-Review (07/2026) — Urteil „Gesellenstück mit Meister-Inseln": Stärken S1–S6, Befunde D1–D10 (Anwender-Doku-Lücke · Drift · stale Vordertüren · OP-Doppel-Wahrheit · Gates ohne Zähne), Empfehlungen E1–E6. | OP-DOCS-14 |
betrieb/Funktionsumfang.md | Funktionsumfang — lebende Feature-Liste (gebaut), nach Workspace-Cluster + Version/OP; pro PR mitpflegen. | Feature-Liste |
betrieb/Roadmap.md | Roadmap & OP-Priorisierung — OPs nach Dringlichkeit + rollierende 4-Wochen-Planung (lebend, interaktiv mit PO geschärft). | OP-PM-3 |
betrieb/Doku-UX-Konzept.md | Doku-UX-Konzept — Doku entwirren (Struktur · Lesbarkeit · Navigation · UX): Diagnose, Zielmodell (3 Ebenen), 5-Phasen-Roadmap, messbare Kriterien. | OP-DOCS-13 |
betrieb/Offene-Punkte.md | Offene Punkte — Live-Übersicht (AUTO-GENERIERT aus ops/*.md) — nach Status gruppiert, gespiegelt nach GitHub Issues für Stakeholder-Diskussion. | OP-DOCS-11 |
betrieb/Timesheet.md | Arbeitszeit-Timesheet (Start/Stop je Session, Gap-Regel, Methodik). | Way-of-Working |
betrieb/Tests.md | Test-Übersicht (lebend) — alle automatischen Tests/Selbsttests/Gates: Befehl · Prüfgegenstand · OP-Bezug · CI-Job; je PR mitführen. | OP-DOCS-9 / Tests & CI |
betrieb/meetings/ | Besprechungs-Protokolle (Meeting-Minutes) — eine Datei je Termin, pyramidal + zielgruppen-gerecht; Index + Vorlage. Beschlüsse zusätzlich am verbindlichen Ort spiegeln. | Audit-Trail / Governance |
konventionen/ — Way-of-Working
| Datei | Inhalt |
|---|---|
konventionen/Entwicklungsansatz.md | Entwicklungsansatz auf einen Blick — True North · Leitprinzipien · Way-of-Working (lesbare Übersicht; CLAUDE.md bleibt verbindlich). Bester Einstieg ins „Warum & Wie". |
konventionen/agents.md | Verbindliche Konventionen für KI-/Coding-Agenten: ID-System, Doku-Format, Branch-/Push-Regeln, Audit-Trail. |
konventionen/IDs.md | ID-Präfix-Legende + Reverse-Lookup „OP → Owning-Dokument". Volle OP-Liste: HANDOFF §4. Begriffe → glossar/Glossar.md. |
konventionen/Register.md | OP- & Entscheidungs-Register — navigierbarer Index aller offenen Punkte (OP-*) + Entscheidungen/Constraints (G·A·S·UC·E), je ID + Kurz-Gloss + Link. Kein Duplikat: Status/Detail bleibt HANDOFF §4 / Lastenheft / Owning-Doc. |
konventionen/Notion-Integration.md | Notion in Claude nutzen (MCP) — eingecheckte .mcp.json (Token via NOTION_TOKEN), Setup für Claude Code (lokal + Cloud) und Claude Desktop, Bereichs-Freigabe (least privilege). |
konventionen/OP-Management-Gold-Standard.md | OP-Management Gold-Standard (OP-DOCS-11) — offene Punkte als ops/*.md (Quelle) → generierte Übersicht + einseitiger GitHub-Issues-Spiegel für Stakeholder-Diskussion, ohne Git-Kenntnisse; Rollout-Checkliste für andere drkv-Projekte. |
produkt/ — Produkt & Markt
| Datei | Inhalt |
|---|---|
produkt/Produkt-und-Marketing.md | Nicht-technisch: Marktbeobachtung (automotivo.de), Nutzenversprechen, Vorteilsrechner/ROI. |
produkt/Wettbewerbsanalyse.md | Nicht-technisch: Wettbewerbslandschaft (4 Kategorien), Differenzierungsmatrix, SWOT (OP-COMPETE-1). |
produkt/Markt-und-Markteintritt.md | Nicht-technisch: Marktabschätzung (TAM/SAM/SOM), Zielsegmente/Beachhead, Go-to-Market-Phasen, Pricing-Hypothese (OP-MARKET-1). |
produkt/Design-Entscheidungen.md | Design-Decision-Log (ADR-Stil, DD-001…008) — das WARUM hinter dem Redesign „Flusslinie/Modernist" (OP-REDESIGN-1); aus dem Claude-Design-Handoff. Prototyp-Referenz: design/prototype/flusslinie/. |
Dokumente außerhalb von docs/ (Repo-Root)
| Datei | Inhalt |
|---|---|
../HANDOFF.md | Kompakter Gesamtstand + offene Punkte (§4) — 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, Tests. |
../design/ | Design-System-Detailvertrag (CLAUDE.md, DESIGN_TOKENS.md, COMPONENTS.md, WORKSPACES.md). |
ID-System (Commits referenzieren IDs): G-n global · R-n Module · Rn-F## Felder ·
A-n Architektur · S-n Vereinfachungen · OP-Rn-n / OP-<Thema>-n offene Punkte ·
UC-x · FR-n · FM-n. Details: konventionen/agents.md §3.
Diese Landkarte ist der Einstieg beim Browsen von
docs/(GitHub) und die Startseite der Doku-Site (docs.taktano.com). Neue Dokumente in den passenden Unterordner legen und hier eintragen (in eigenem Ordner ein_category_.jsonmitlabel+positionergänzen), damit Übersicht und Sidebar aktuell bleiben.