Zum Inhalt springen
Tagwerk-Doku

Entwicklung & Deployment

Lokale Entwicklung

Abschnitt betitelt „Lokale Entwicklung“
Terminal-Fenster
cd app
npm install
npm run dev        # Vite-Dev-Server

Die Datenquelle steuert VITE_DATA_SOURCE:

  • supabase — gegen das echte Backend (Standard),
  • memory — In-Memory-Daten, ohne Backend (für Tests/E2E).

Tests

Abschnitt betitelt „Tests“
Art Werkzeug Zweck
Unit/Integration Vitest reine Logik, Komponenten (jsdom)
End-to-End Playwright App im Memory-Modus, ohne Secrets

Beide laufen im CI (.github/workflows/ci.yml) als Gate. Vitest und der Playwright-Runner sind getrennt — die E2E-Specs unter app/e2e/ sind aus dem Vitest-Lauf ausgeschlossen.

Terminal-Fenster
npm run test       # Vitest
npm run e2e        # Playwright (baut zuerst den Memory-Build)

Release-Disziplin

Abschnitt betitelt „Release-Disziplin“

Bei jedem Deploy:

  1. src/version.ts — APP_VERSION hochzählen.
  2. src/changelog.ts — neuen Eintrag oben ergänzen (Zeitpunkt Europe/Berlin).
  3. src/roadmap.ts — bei abgeschlossenen Meilensteinen ROADMAP_DONE pflegen.
  4. Gate lokal grün: npx tsc --noEmit, npx vitest run, npm run build.
  5. Commit + Push.

Auslieferung

Abschnitt betitelt „Auslieferung“
  • App: Push auf main → Cloudflare Workers Build baut und deployt den Worker tagwerk automatisch (Static Assets aus dist/).
  • Datenbank: Migrationen unter app/supabase/migrations/ werden per supabase db push auf das Projekt angewandt.