Zum Hauptinhalt springen

Taktano — Werkstatt-Betriebssystem (Neuentwicklung)

Repository für die Neuentwicklung eines Werkstatt-Betriebssystems für Fahrzeug-Veredelungsbetriebe — fachlich angelehnt an die analysierte Plattform automotivo.de, technisch frei. Dieses Repo ist die einzige Quelle der Wahrheit: Spezifikation, Architektur-Entscheidungen, Prototyp-Code und Doku liegen hier zusammen ("Everything as Code").

GitHub: https://github.com/drkv-com/taktano

Was ist hier drin?​

PfadWasWer liest das wann
HANDOFF.mdKompakter Stand: alle Entscheidungen mit IDs, offene Punkte, nächste Schritte.Erstes Dokument für jede neue Session / jeden neuen Mitarbeiter / jeden Gerätewechsel.
docs/README.mdDoku-Landkarte: alle docs/ nach Zweck gruppiert (Fachliche Spec · Architektur-Design · Betrieb/Governance · Konventionen · Produkt).Zum Navigieren der Dokumentation — findet das richtige Dokument schneller als die flache Liste.
docs/fachlich/Lastenheft.mdVollständige fachliche Spezifikation in Markdown + Mermaid-Diagrammen (Datenmodell, Lifecycle, Architektur).Wenn du die Master-Spec brauchst.
docs/konventionen/agents.mdKonventionen für KI-Agenten und Coding-Agenten (md+mermaid, ID-System, Workflow).Bei jeder neuen Session zusammen mit HANDOFF.md lesen.
server/Cloudflare Worker + Durable Object (partyserver). Hält den Live-State des Leitstands und broadcastet via WebSocket.Backend des Prototyps.
client/Angular 22 Standalone-App (Signals, Tailwind v4). Konsumiert den Server über partysocket, rendert das Leitstand-UI.Frontend des Prototyps.
docs/anwender/Anwender-Handbuch: Schritt-für-Schritt-Anleitungen für das Werkstatt-Team (Fahrzeug annehmen, Klärfall melden, Mein Arbeitstag …).Einstieg für Anwender — kein Technik-Vorwissen nötig.

Voraussetzungen​

  • Node.js 22 (siehe .nvmrc; wrangler@4 verlangt Node 22+).
  • npm (oder pnpm/yarn).
  • Für den CP-SAT-Solver-Service optional: Python 3.12 (solver-service/).

Quick Start (lokal)​

Zwei Terminals.

Server (Worker + Durable Object):

cd server
npm install
npm run dev          # → http://127.0.0.1:8787 (wrangler dev / Miniflare)

Client (Angular):

cd client
npm install
npm start            # → http://localhost:4200

Tab duplizieren → Status oder Bay-Belegung in einem Tab ändern → der andere aktualisiert sich live.

Beim ersten wrangler dev: falls über [assets]-Block in wrangler.toml ein fehlendes Verzeichnis gemeldet wird, einmal mkdir -p client/dist/leitstand/browser && touch client/dist/leitstand/browser/.keep und neu starten.

Deploy auf eigenen Cloudflare-Account​

cd server
npx wrangler login        # einmalig, öffnet Browser-OAuth
npm run deploy            # baut den Client und ruft wrangler deploy

Produktiv-Endpunkt: https://app.taktano.com (Custom-Domain-Route in server/wrangler.toml) — Worker und statischer Angular-Client liegen unter derselben URL.

Wir sind nicht auf der gehosteten PartyKit-Plattform (*.partykit.dev), weil deren shared Zone das Cloudflare-Limit von 10.000 Custom Domains erreicht hat. Wir nutzen partyserver als Library und deployen direkt auf dein eigenes Cloudflare-Konto via wrangler. Details siehe HANDOFF.md §6.

Tests & Checks (on demand)​

Alle automatischen Tests/Checks laufen on demand lokal und in der CI/CD (.github/workflows/ci.yml, Node 22 / Python 3.12). Die Kern-Befehle:

# Server (TypeScript): Typecheck + Selbsttests
cd server
npm run typecheck      # tsc --noEmit
npm run spike          # Scheduler-Demo (Beispiel — es gibt >30 test:*-Selbsttests)

# CP-SAT-Solver-Service (Python OR-Tools): Self-Tests
cd ../solver-service
python model.py

# Client (Angular): Production-Build
cd ../client
npm run build

➜ Vollständige, lebende Liste aller Tests/Selbsttests/Gates: docs/betrieb/Tests.md (Befehl · Prüfgegenstand · CI-Job). Neue Tests immer on-demand und in der CI ergänzen — und dort eintragen.

Lastenheft lesen / ändern​

docs/fachlich/Lastenheft.md direkt im Editor öffnen. Mermaid-Diagramme rendern in GitHub und in den meisten Markdown-Tools nativ. Falls jemand einen statischen PDF/DOCX-Export braucht, lokal via pandoc generieren — nicht committen (siehe docs/konventionen/agents.md §2).

Mitarbeiten — neue Cowork-Session​

  1. Repo clonen oder ziehen.
  2. In Cowork den Repo-Ordner als Working-Folder wählen.
  3. In der ersten Nachricht "Lies HANDOFF.md und docs/konventionen/agents.md" sagen — der Agent hat damit Stand + Konventionen.

Konventionen​

  • IDs überall: Globale Prinzipien G-1..3, Module R1..R9, Felder Rx-F##, Vereinfachungen S-1..10, Architektur A-1..5, offene Punkte OP-Rx-#, Future Releases FR-#, Future Modules FM-#. Beim Diskutieren / Commit bitte ID referenzieren.
  • Single Source of Truth: alle Entscheidungen, Specs und Code im Repo. Konversations-Wissen, das überlebenswert ist, landet in einem *.md im Repo.
  • Lastenheft + HANDOFF.md sind die einzigen Stellen, an denen ungelöste Fragen geparkt werden. Wenn du etwas entscheidest, dort einpflegen.

Lizenz​

Aktuell privat / proprietär (kein Lizenz-Header).

Letztes Update: 12.07.2026 (Doku-Review OP-DOCS-14 — README auf Ist-Stand gebracht).