Formtest Entwicklerdoku

Diese Dokumentation beschreibt die aktuelle Implementierung von W:\Protocol_App\formtest.

Sie ist bewusst auf Verhalten begrenzt, das sich im Code verifizieren lässt. Historische Hinweise, Backlog-Inhalte, Roadmaps und spekulative Architektur sind ausgeschlossen.

Technische Basis

• Nuxt-4-SPA mit ssr: false
• Pinia für den Anwendungszustand
• Dexie für lokale Persistenz
• Nuxt UI für gemeinsame UI-Komponenten
• Vitest mit getrennten Projekten unit und nuxt
• Playwright für app-fokussierte Browser- und E2E-Flows
• Deutsch ist die konfigurierte Standardsprache

Zentrale Runtime-Bereiche

• app/plugins/00.ivm.ts: authentifizierter Server-Fetch-Client mit Login-Popup und Retry
• app/plugins/01.appInit.client.ts: lädt Setup-Daten direkt beim App-Start
• app/plugins/03.dexieSync.client.ts: erweitert Pinia-Stores um Dexie-Persistenz, Dirty-Tracking und Server-Sync
• app/middleware/determiner.ts: query-gesteuertes Routing und Gating für Signatur- und Finalisierungsschritte
• app/utils/protocolWorkflow.ts: zentraler Guard- und Redirect-Helper für Kundenansicht, Signatur und Finalize
• app/pages/index.vue: Hülle des Protokoll-Editors
• app/pages/customer-view*: Vorschau- und Signaturfluss
• app/pages/finalize.vue: Finalisierungs- und Archivierungsfluss

Architekturüberblick

Dokumentationsübersicht

• Runtime und Routing: /runtime-config, /routing-middleware, /api-layer
• Editor und Settings: /create-flow, /app-lifecycle-demo, /editor-flow, /history-flow, /settings-architecture
• Daten und Sync: /database-architecture, /server-sync, /store-factory
• Kundenfluss: /customer-view-flow, /pdf-handling, /finalize-flow, /image-upload-offline, /protocol-clone-framework
• Assistenzfunktionen: /ai-assistants
• Formular-Helfer: /add-new-section, /section-architecture, /room-capture-flow, /use-form-save, /use-unsaved-changes, /use-store-field, /signature-pad
• Qualitätssicherung: /testing-strategy