Zum Hauptinhalt springen

Lesepfade nach Zielgruppe

Die Taktano-Doku bedient sieben unterschiedliche Leserkreise. Diese Seite ist der Einstieg nach Rolle: Sie sortiert die bestehenden Dokumente zu kuratierten Lesepfaden — was du in welcher Reihenfolge liest, worauf es für deine Rolle ankommt, und welche Begriffe du kennen solltest. Die Inhalte selbst bleiben an einer Stelle (Everything-as-Code); diese Seite verlinkt nur, sie dupliziert nicht.

Leitprinzip „Dokumentation als Meisterwerk" (CLAUDE.md): klar/knapp/korrekt, zielgruppen-gerecht, pyramidal (Kernaussage zuerst, dann Gründe, dann Details) und visuell, wo es trägt (Mermaid). Diese Seite ist die Rollen-Landkarte dazu.

Begriffs-Sprechblasen: In der gesamten Doku sind Fachbegriffe dezent unterstrichen — fahre mit der Maus darüber oder tippe/klicke sie an, dann erscheint die Kurz-Erklärung aus dem Glossar. Probiere es gleich hier: CP-SAT, Makespan, Durchlaufzeit, Leitstand, Durable Object.

Jedes Feature und jedes Dokument muss mindestens eine der drei True North-Leitfragen direkter, schneller oder genauer beantworten (lebende Prüfliste mit Status → Sanity-Checkliste): (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?

ZielgruppeKürzelKurzSprung
Anwender (Werkstatt-Team)nutzerbedient Taktano im Tagesgeschäft↓
Fach / Management (nicht-IT)fachbewertet Nutzen, Prozess, Wirtschaftlichkeit↓
IT-Architektur & -Entwicklungitdevbaut und erweitert das System↓
IT-Operationsitopsbetreibt, überwacht, sichert ab↓
DevOpsdevopsCI/CD, Deploy, Build-/Release-Pipeline, IaC↓
CISO / SecuritysecurityCompliance, Risiko, Audit, Datenschutz (DE/AT/CH)↓
Customer ServicesupportSupport, Onboarding, FAQ, Eskalation↓

Nach Aufgabe — geführte Einstiege​

Ergänzend zu den Rollen-Lesepfaden oben: geführte Einstiege je nach Ziel (Reihenfolge von links nach rechts).

Ich will …Pfad
die App im Alltag bedienenanwender/Handbuch.md → Mein Arbeitstag · Klärfall · Fahrzeug annehmen
Onboarding / neue SessionHANDOFF.md → Lastenheft.md → agents.md
den Scheduler / die Taktung verstehenLastenheft.md §6 → solver.md → datamodel.md → operativmodell.md
einen PR machen / committenagents.md (§6/§7) → Timesheet.md → CHANGELOG.md
eine Architektur-Entscheidung nachschlagenRegister.md (alle OP + Entscheidungen) → IDs.md (OP → Doc) → passendes Dokument in architektur/
einen Begriff nachschlagenGlossar.md → maßgebliche Quelle (verlinkt)

Anwender — Werkstatt-Team​

Wer: Mitarbeitende, die Aufträge annehmen, Fahrzeuge einplanen, Teilschritte abarbeiten, parken und die Qualität freigeben. Worauf es ankommt: den Tagesablauf im Cockpit beherrschen — Auslastung sehen, wissen, wo jedes Fahrzeug steht, und freie Kapazitäten erkennen.

Lesepfad:

  1. Anwender-Handbuch — erste Schritte — die App bedienen, in Werkstattsprache mit den echten Knopf-Beschriftungen (Bereiche, Werker-Modus, Status-Wörter).
  2. Mein Arbeitstag — Name wählen, ⏸/▶/✓, Doku & Pflicht-Fotos.
  3. Klärfall melden & lösen — wenn etwas klemmt: melden in drei Schritten.
  4. Fahrzeug annehmen — Auftrag anlegen mit einem Satz, Check-in „🚗 Fahrzeug da".
  5. Vertiefung (optional): Produkt & Nutzen — wofür Taktano da ist, in Klartext.

Begriffe, die du kennen solltest: Auftrag, Teilschritt, Bucht, Belegung, Eilauftrag, Reserve, Standzeit, Cool-down.

Fach / Management — nicht-IT​

Wer: Inhaber, Betriebsleitung, Fachleute ohne IT-Hintergrund, die Nutzen, Prozessqualität und Wirtschaftlichkeit beurteilen. Worauf es ankommt: verstehen, was das System leistet und warum die Optimierung welche Entscheidung trifft — ohne den Code zu lesen.

Lesepfad:

  1. Produkt & Marketing — Nutzenversprechen, Markt, ROI/Vorteilsrechner.
  2. Wettbewerbsanalyse — Wettbewerbslandschaft, Differenzierung, SWOT (OP-COMPETE-1).
  3. Markt & Markteintritt — Marktgröße (TAM/SAM/SOM), Zielsegmente, Go-to-Market, Pricing-Hypothese (OP-MARKET-1).
  4. Sanity-Checkliste (True North) — die drei Leitfragen als lebende Prüfliste.
  5. Globaler Optimierer / Solver — was „optimal“ heißt (Zielfunktion), in Worten und an einem Beispiel.
  6. Compliance & Risikoregister — Zertifizierung, Datenschutz, Risiken (DE/AT/CH).

Begriffe, die du kennen solltest: CP-SAT, Taktung, Zielfunktion, Makespan, Durchlaufzeit, Termintreue, Güteklasse, Compliance, DSGVO.

IT-Architektur & -Entwicklung​

Wer: Entwickler:innen und Architekt:innen, die Taktano bauen, erweitern und gegen die fachliche Spezifikation absichern. Worauf es ankommt: Datenmodell, Scheduler/Solver-Zusammenspiel, Constraints und die Way-of-Working-Konventionen.

Lesepfad:

  1. Doku-Landkarte — alle Dokumente nach Zweck, plus Session-Start-Reihenfolge.
  2. Lastenheft — die fachliche Master-Spec (Module R1–R9, IDs, Datenmodell §4.9, Optimierungsziel §6.2).
  3. Datenmodell — Stammdaten = Solver-Eingabe.
  4. Globaler Optimierer / Solver — Decoder-Ansatz, CP-SAT-Service, Constraints, Zielterme.
  5. Konventionen für Agenten — ID-System, Branch-/Audit-Regeln, Way-of-Working.
  6. Architektur-Designs je offenem Punkt: Audit-Log, Kosten, In-App-Assistent, Billing & Zugang, Akademie.

Begriffe, die du kennen solltest: Solver, CP-SAT, OR-Tools, Scheduler, Decoder, Constraint, Eligibility, Durable Object, Cloudflare Worker, partyserver.

IT-Operations​

Wer: Betrieb/SRE — Deployment, Monitoring, Verfügbarkeit, Sicherheit und Compliance im laufenden Betrieb. Worauf es ankommt: wie Taktano deployt, beobachtet und abgesichert wird, und wo die Single-Source-of-Truth für Version/Build und Abhängigkeiten liegt.

Lesepfad:

  1. Doku-Landkarte — Gesamtüberblick + Einstieg (verlinkt u. a. Projekt-README mit Quick-Start/Tests und den Handoff).
  2. Globaler Optimierer / Solver §4–5 — Solver-Service (Fly.io), SOLVER_URL, Fallback-Verhalten.
  3. Compliance & Risikoregister — SBOM, Audit-Bereitschaft, Risiken.
  4. Audit-Log-Architektur — D1, Retention, Manipulationssicherheit.
  5. Billing & Zugang — zahlungs-gesteuerter Zugang, Cloudflare Access.

Begriffe, die du kennen solltest: Cloudflare Worker, Durable Object, Solver-Service, Fly.io, Cloudflare Access, D1, OpenTelemetry, trace_id, SBOM, SemVer.

DevOps​

Wer: CI/CD- und Plattform-Verantwortliche — Build-Pipeline, Releases, Deploy auf Cloudflare Worker und den Solver-Service, Infrastruktur als Code. Worauf es ankommt: wie ein Commit grün durch CI nach Prod kommt, wie Version/Build gestempelt werden und wie parallele PRs konfliktarm zusammenlaufen.

Lesepfad:

  1. Doku-Landkarte → Projekt-README — Quick-Start, Tests/Self-Tests, Build.
  2. Konventionen für Agenten §6–7 — Branch-/Merge-Strategie, GitHub-Operationen, Repo-Settings (Squash/Auto-Merge), Log-Hygiene (OP-PM-2).
  3. Globaler Optimierer / Solver §4–5 — Solver-Service (Fly.io), SOLVER_URL, Deploy & Fallback.
  4. Observability — OTel/OTLP-Backend, Telemetrie-Verdrahtung (OP-OBS-1).
  5. Version/Build: server/src/version.ts (APP_VERSION, manuell je PR) + auto-gestempelte Build-Nummer (scripts/stamp-build.mjs); SBOM-CI (OP-SBOM-1).

Begriffe, die du kennen solltest: Cloudflare Worker, Durable Object, Fly.io, SemVer, SBOM, OpenTelemetry.

CISO / Security​

Wer: Sicherheits-/Compliance-Verantwortliche — Datenschutz, Audit-Bereitschaft, Risiko und Zertifizierung für die Zielmärkte DE/AT/CH. Worauf es ankommt: welche Belege existieren, wie Manipulationssicherheit und Datenresidenz gewährleistet sind, und wo die Risiken samt Maßnahmen geführt werden.

Lesepfad:

  1. Compliance — Zertifizierungs-/Audit-Bereitschaft (TÜV · ISO 27001 · Security-Audit), Belege/Checklisten.
  2. Risikoregister — geführte Risiken + Maßnahmen/Status.
  3. Audit-Log-Architektur — append-only, „nicht reverse-engineerbar", Retention, D1.
  4. Observability — Telemetrie-Backend & EU-Datenresidenz (OP-OBS-1); SBOM-CI (OP-SBOM-1) für Lieferketten-Transparenz.
  5. Billing & Zugang — Cloudflare Access, rollen-/zahlungs-gesteuerter Zugang.

Begriffe, die du kennen solltest: Compliance, DSGVO, SBOM, Cloudflare Access, D1, trace_id.

Customer Service​

Wer: Support/Onboarding — begleitet Werkstatt-Kunden bei Einführung und Tagesbetrieb, beantwortet Fragen, eskaliert Fehler an Dev/Ops. Worauf es ankommt: das Produkt in Kundensprache erklären, den Standard-Prozess und die Begriffe sicher beherrschen, und wissen, was Taktano (noch) nicht tut.

Lesepfad:

  1. Anwender-Handbuch — die App aus Kundensicht: Bereiche, Alltags-Flows (Mein Arbeitstag · Klärfall · Fahrzeug annehmen), Status-Wörter — die Basis für jedes Support-Gespräch.
  2. Produkt & Nutzen — Nutzenversprechen + Vokabular in Klartext.
  3. Sanity-Checkliste (True North) — was das System belastbar beantwortet (✅/🟡/⛔) — ehrlich gegenüber Kunden.
  4. In-App-Assistent — geplante geführte Hilfe/FAQ im Produkt.
  5. Glossar — die Begriffe, die in jedem Kundengespräch fallen.

Begriffe, die du kennen solltest: Auftrag, Teilschritt, Leitstand, Eilauftrag, Termintreue, Durchlaufzeit.

Hintergrund: Diese Seite ist der erste Schritt zur sauberen Trennung von Anwender- und technischer/interner Doku (OP-DOCS-4) — vorerst als nicht-invasiver Überbau über die bestehende Struktur, ohne Dateien zu verschieben. Die feinere Trennung (eigene Bereiche, login-abhängige Sichtbarkeit) ist als OP-DOCS-4/-5 im Handoff §4 geführt (Einstieg über die Doku-Landkarte).