docs(06): capture phase context
This commit is contained in:
@@ -0,0 +1,113 @@
|
||||
# Phase 6: Desktop Client & CI/CD - Context
|
||||
|
||||
**Gathered:** 2026-06-25
|
||||
**Status:** Ready for planning
|
||||
|
||||
<domain>
|
||||
## Phase Boundary
|
||||
|
||||
Tauri 2.x Desktop-Wrapper fuer die bestehende Tessera Web-App (Windows + Linux) mit System Tray, nativen Benachrichtigungen und konfigurierbarer Server-URL. Plus DevOps-Automatisierung: Gitea als Git-Remote einrichten, Gitea Actions CI/CD Pipeline (Lint, Tests, Docker Build, Auto-Deploy auf gleichen Server). WICHTIG: Gitea-Integration ist KEIN Feature von Tessera — es ist Tooling fuer den Entwicklungsworkflow. Claude (nicht die App) pusht manuell bei Meilensteinen/grossen Bugfixes.
|
||||
|
||||
</domain>
|
||||
|
||||
<decisions>
|
||||
## Implementation Decisions
|
||||
|
||||
### Desktop-App Verhalten
|
||||
- **D-01:** Wrapper mit System Tray und nativen OS-Benachrichtigungen (z.B. Kalender-Erinnerungen). Braucht Backend-Integration fuer Notification-Events.
|
||||
- **D-02:** Server-URL konfigurierbar beim ersten Start. Wird lokal gespeichert. Ein Build fuer alle Umgebungen.
|
||||
- **D-03:** Beim Schliessen des Fensters (X-Button) wird in System Tray minimiert. Beenden nur ueber Tray-Kontextmenu.
|
||||
- **D-04:** Autostart-Option in Desktop-App-Einstellungen vorhanden, standardmaessig deaktiviert.
|
||||
|
||||
### Fenster & Erscheinung
|
||||
- **D-05:** Fensterposition und -groesse werden beim Schliessen gespeichert, beim naechsten Start wiederhergestellt. Erster Start: 1280x800 zentriert.
|
||||
- **D-06:** Eigenes Tessera-App-Icon (basierend auf Design-System, OKLCH Farben).
|
||||
|
||||
### Build & Verteilung
|
||||
- **D-07:** Linux: AppImage als primaeres Format (distro-uebergreifend).
|
||||
- **D-08:** Update-Hinweis: App prueft beim Start ob neue Version verfuegbar, zeigt Notification. Download bleibt manuell. Auto-Update kann spaeter nachgeruestet werden.
|
||||
- **D-09:** Code Signing kommt spaeter — erst relevant wenn Tessera an externe Kunden verkauft wird. Fuer interne Nutzung ohne Signierung OK.
|
||||
|
||||
### Gitea-Automatisierung (DevOps, KEIN App-Feature)
|
||||
- **D-10:** Gitea ist reines Versionskontroll- und CI/CD-Tooling. Tessera hat keine Git/Gitea-Funktionalitaet in der App.
|
||||
- **D-11:** Claude pusht manuell bei Meilensteinen oder grossen Bugfixes nach Gitea. Kein automatischer Sync, kein zeitgesteuerter Push.
|
||||
- **D-12:** Gitea Actions CI/CD Pipeline wird bei jedem Push getriggert: Lint + TypeCheck → Tests (Vitest) → Docker Images bauen → Auto-Deploy.
|
||||
- **D-13:** Deploy-Ziel ist gleicher Server wie Gitea. Pipeline macht docker-compose pull + restart.
|
||||
|
||||
### Claude's Discretion
|
||||
- Titelleiste: Nativ vs. Custom — basierend auf Aufwand und Design-System
|
||||
- App-Menueleiste: Kein Menu vs. minimales Menu — basierend auf Plattform-Konventionen
|
||||
- Windows Installer-Format: MSI vs. NSIS — basierend auf Zielgruppe (intern, spaeter extern)
|
||||
- Gitea Actions Workflow-Struktur und Stage-Konfiguration
|
||||
- Docker Image Registry: Gitea-intern vs. lokal
|
||||
|
||||
</decisions>
|
||||
|
||||
<canonical_refs>
|
||||
## Canonical References
|
||||
|
||||
**Downstream agents MUST read these before planning or implementing.**
|
||||
|
||||
### Projekt-Kontext
|
||||
- `.planning/PROJECT.md` — Gesamtprojekt, Core Value, Constraints
|
||||
- `.planning/REQUIREMENTS.md` — Phase-6-Requirements: DESK-01, DESK-02, INFRA-04
|
||||
- `.planning/ROADMAP.md` — Phase-Ziel und Success Criteria
|
||||
|
||||
### Vorherige Phasen
|
||||
- `.planning/phases/01-foundation-portal-shell/01-CONTEXT.md` — Design-Entscheidungen, OKLCH Tokens (relevant fuer App-Icon)
|
||||
- `.planning/phases/05-dashboard-calendar/05-CONTEXT.md` — Dashboard/Kalender (relevant fuer native Notifications)
|
||||
|
||||
### Technologie
|
||||
- `docker-compose.yml` — Bestehende Container-Konfiguration (web, api, db). Deploy-Target fuer CI/CD
|
||||
- `pnpm-workspace.yaml` — Monorepo-Struktur (apps/*, packages/*)
|
||||
- `apps/web/Dockerfile` — Web-Image Build
|
||||
- `apps/api/Dockerfile` — API-Image Build
|
||||
|
||||
</canonical_refs>
|
||||
|
||||
<code_context>
|
||||
## Existing Code Insights
|
||||
|
||||
### Reusable Assets
|
||||
- `docker-compose.yml` — Bestehende Service-Definitionen (web, api, db). CI/CD Deploy baut darauf auf.
|
||||
- `apps/web/Dockerfile` + `apps/api/Dockerfile` — Produktions-Dockerfiles bereits vorhanden
|
||||
- Design Tokens (OKLCH) in `apps/web` — Basis fuer App-Icon-Farben
|
||||
|
||||
### Established Patterns
|
||||
- pnpm Workspace mit `apps/*` und `packages/*` — Desktop-App wird `apps/desktop`
|
||||
- Docker Compose mit Netzwerk-Segmentierung (frontend-net, backend-net, data-net)
|
||||
- Health Checks fuer alle Services
|
||||
|
||||
### Integration Points
|
||||
- `apps/desktop` — Neues Tauri-Projekt im Monorepo
|
||||
- `.gitea/workflows/` — Gitea Actions Workflow-Dateien (neu)
|
||||
- Gitea Remote muss eingerichtet werden (aktuell kein Remote konfiguriert)
|
||||
- Desktop-App laedt `http://<konfigurierte-url>:3000` (Web-Frontend)
|
||||
- Notification-Backend braucht evtl. WebSocket/SSE Endpoint in `apps/api`
|
||||
|
||||
</code_context>
|
||||
|
||||
<specifics>
|
||||
## Specific Ideas
|
||||
|
||||
- Desktop-App ist reiner Wrapper — die gesamte Logik bleibt in der Web-App
|
||||
- Tray-Icon zeigt Tessera-Logo, Rechtsklick-Menu mit: Oeffnen, Beenden
|
||||
- Erster Start zeigt Eingabefeld fuer Server-URL, danach direkt zur Web-App
|
||||
- Gitea Actions Pipeline als Multi-Stage: erst Qualitaet pruefen, dann bauen, dann deployen
|
||||
|
||||
</specifics>
|
||||
|
||||
<deferred>
|
||||
## Deferred Ideas
|
||||
|
||||
- **Auto-Update mit Tauri Updater:** Kann spaeter nachgeruestet werden wenn Update-Server verfuegbar
|
||||
- **Code Signing:** Wird relevant bei externem Verkauf
|
||||
- **macOS Support:** Aktuell nur Windows + Linux, Mac spaeter bei Bedarf
|
||||
- **Gitea Webhooks fuer externe Events:** z.B. Issue-Tracking Integration
|
||||
|
||||
</deferred>
|
||||
|
||||
---
|
||||
|
||||
*Phase: 06-Desktop Client & CI/CD*
|
||||
*Context gathered: 2026-06-25*
|
||||
@@ -0,0 +1,153 @@
|
||||
# Phase 6: Desktop Client & CI/CD - Discussion Log
|
||||
|
||||
> **Audit trail only.** Do not use as input to planning, research, or execution agents.
|
||||
> Decisions are captured in CONTEXT.md — this log preserves the alternatives considered.
|
||||
|
||||
**Date:** 2026-06-25
|
||||
**Phase:** 06-desktop-client-ci-cd
|
||||
**Areas discussed:** Desktop-App Verhalten, Fenster & Erscheinung, Build & Verteilung, Gitea-Automatisierung
|
||||
|
||||
---
|
||||
|
||||
## Desktop-App Verhalten
|
||||
|
||||
| Option | Description | Selected |
|
||||
|--------|-------------|----------|
|
||||
| Reiner Wrapper | Nur Fenster mit Web-App, keine nativen Features | |
|
||||
| Wrapper + System Tray | Web-App + Tray + Autostart | |
|
||||
| Wrapper + Tray + Notifications | Wie oben + native OS-Benachrichtigungen | ✓ |
|
||||
|
||||
**User's choice:** Wrapper + Tray + Notifications
|
||||
|
||||
| Option | Description | Selected |
|
||||
|--------|-------------|----------|
|
||||
| Feste URL | Server-Adresse beim Build eingebaut | |
|
||||
| Konfigurierbar | Benutzer gibt URL beim ersten Start ein | ✓ |
|
||||
| Auto-Discovery | mDNS/Bonjour im lokalen Netz | |
|
||||
|
||||
**User's choice:** Konfigurierbar
|
||||
|
||||
| Option | Description | Selected |
|
||||
|--------|-------------|----------|
|
||||
| In Tray minimieren | App bleibt im Tray, Beenden nur ueber Menu | ✓ |
|
||||
| Beenden mit Nachfrage | Dialog beim X-Klick | |
|
||||
| Konfigurierbar | In Einstellungen waehlbar | |
|
||||
|
||||
**User's choice:** In Tray minimieren
|
||||
|
||||
| Option | Description | Selected |
|
||||
|--------|-------------|----------|
|
||||
| Ja, standardmaessig | Autostart aktiviert per default | |
|
||||
| Nein, manuell | Kein Autostart | |
|
||||
| Optional, aus | Option vorhanden, Standard: deaktiviert | ✓ |
|
||||
|
||||
**User's choice:** Optional, aus
|
||||
|
||||
---
|
||||
|
||||
## Fenster & Erscheinung
|
||||
|
||||
| Option | Description | Selected |
|
||||
|--------|-------------|----------|
|
||||
| Native OS-Titelleiste | Standard-Fensterrahmen | |
|
||||
| Custom Titelleiste | Eigene Titelleiste im Tessera-Design | |
|
||||
| Claude entscheidet | Basierend auf Aufwand und Design-System | ✓ |
|
||||
|
||||
**User's choice:** Claude entscheidet
|
||||
|
||||
| Option | Description | Selected |
|
||||
|--------|-------------|----------|
|
||||
| Maximiert | Startet im Vollbildmodus | |
|
||||
| Zentriert 1280x800 | Feste Startgroesse | |
|
||||
| Letzten Zustand merken | Speichert Position + Groesse | ✓ |
|
||||
|
||||
**User's choice:** Letzten Zustand merken
|
||||
|
||||
| Option | Description | Selected |
|
||||
|--------|-------------|----------|
|
||||
| Kein App-Menu | Nur Web-Oberflaeche | |
|
||||
| Minimales Menu | Beenden, Info/Version | |
|
||||
| Claude entscheidet | Basierend auf Plattform-Konventionen | ✓ |
|
||||
|
||||
**User's choice:** Claude entscheidet
|
||||
|
||||
| Option | Description | Selected |
|
||||
|--------|-------------|----------|
|
||||
| Eigenes Tessera-Icon | Brauchen Icon-Design | ✓ |
|
||||
| Platzhalter-Icon | Standard-Tauri-Icon erstmal | |
|
||||
| Claude erstellt eins | Generiertes Icon basierend auf Design-System | |
|
||||
|
||||
**User's choice:** Eigenes Tessera-Icon
|
||||
|
||||
---
|
||||
|
||||
## Build & Verteilung
|
||||
|
||||
**Linux-Format:**
|
||||
**User's choice:** AppImage (distro-uebergreifend)
|
||||
**Notes:** User betonte Distro-Unabhaengigkeit als Prioritaet
|
||||
|
||||
| Option | Description | Selected |
|
||||
|--------|-------------|----------|
|
||||
| MSI | Windows Installer, Enterprise | |
|
||||
| NSIS (EXE) | Setup-Wizard | |
|
||||
| Beide | MSI + EXE | |
|
||||
| Claude entscheidet | Basierend auf Zielgruppe | ✓ |
|
||||
|
||||
**User's choice:** Claude entscheidet (Windows Installer-Format)
|
||||
|
||||
**Auto-Update:**
|
||||
**Claude's Empfehlung angenommen:** Update-Hinweis (prueft ob neue Version da, zeigt Notification, manueller Download)
|
||||
|
||||
| Option | Description | Selected |
|
||||
|--------|-------------|----------|
|
||||
| Ohne Signierung | Windows zeigt Warnung, fuer intern OK | |
|
||||
| Spaeter | Erst relevant bei externem Verkauf | ✓ |
|
||||
| Claude entscheidet | | |
|
||||
|
||||
**User's choice:** Spaeter
|
||||
|
||||
---
|
||||
|
||||
## Gitea-Automatisierung
|
||||
|
||||
**Kritische Klaerung:** User stellte klar dass Gitea-Integration KEIN Feature der Tessera-App ist. Git/Gitea ist reines Entwicklungs-Tooling. Claude (nicht die App) pushed Code nach Gitea bei Meilensteinen.
|
||||
|
||||
| Option | Description | Selected |
|
||||
|--------|-------------|----------|
|
||||
| Nur Auto-Push | Automatisch committed und gepusht | |
|
||||
| Push + CI Pipeline | Auto-Push + Gitea Actions | |
|
||||
| Full CI/CD | Push + Build/Test + Docker + Deploy | ✓ |
|
||||
|
||||
**User's choice:** Full CI/CD
|
||||
**Notes:** Push ist NICHT automatisch — Claude pusht manuell bei Meilensteinen/grossen Bugfixes
|
||||
|
||||
**Pipeline-Schritte (alle gewaehlt):**
|
||||
- Lint + Type Check ✓
|
||||
- Tests ausfuehren ✓
|
||||
- Docker Images bauen ✓
|
||||
- Auto-Deploy ✓
|
||||
|
||||
| Option | Description | Selected |
|
||||
|--------|-------------|----------|
|
||||
| Gleicher Server | Tessera + Gitea auf einem Server | ✓ |
|
||||
| Separater Server | Tessera woanders, Images ueber Registry | |
|
||||
|
||||
**User's choice:** Gleicher Server
|
||||
|
||||
---
|
||||
|
||||
## Claude's Discretion
|
||||
|
||||
- Titelleiste: Nativ vs. Custom
|
||||
- App-Menueleiste: Kein Menu vs. minimales Menu
|
||||
- Windows Installer-Format: MSI vs. NSIS
|
||||
- Gitea Actions Workflow-Struktur
|
||||
- Docker Image Registry Strategie
|
||||
|
||||
## Deferred Ideas
|
||||
|
||||
- Auto-Update mit Tauri Updater (spaeter wenn Update-Server verfuegbar)
|
||||
- Code Signing (bei externem Verkauf)
|
||||
- macOS Support
|
||||
- Gitea Webhooks fuer externe Events
|
||||
Reference in New Issue
Block a user