till/wordeck-native
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Native SwiftUI-Universal-App für Cardecky (mana e.V.). Web-Parität zu cardecky.mana.how. SOT: mana/docs/playbooks/CARDS_NATIVE_GREENFIELD.md
45 commits 1 branch 22 tags 7 MiB
Find a file
Till JS 9527240bcc feat(offline): text-only Cleanup + ζ-1 Offline-Sync 
Drei zusammenhängende Blöcke in einem Commit (Files überlappen sich
zwischen den Themen — sauberer Split nicht ohne Friktion möglich):

1. Wordeck-Text-Only-Cleanup
   Image-Occlusion + Audio-Front-Code raus. Server ist seit Migration
   0004_wordeck_text_only.sql text-only (in Prod waren 0 Karten der
   Typen, 0 Media-Files). Native-Code war Build-11-Altlast.
   - Gelöscht: MediaCache, MediaEnvironment, RemoteImage,
     AudioPlayerButton, MaskEditorView, CardEditorMediaFields,
     CardEditorPayload, Media.swift
   - CardType-Enum auf 5 Werte: basic / basic-reverse / cloze /
     typing / multiple-choice
   - media_refs aus Card, CardCreateBody, CardUpdateBody, call-sites
   - WordeckAPI.uploadMedia / .fetchMedia / .deleteMedia + Single-File-
     makeMultipartBody gestrichen
   - MarketplaceCardConverter ohne Media-Cases
   - CardRenderer ohne imageOcclusionView / audioFrontView

2. AI-Media-Mode raus
   /decks/from-image-Endpoint existiert serverseitig nicht (server
   registriert nur /decks/generate für Text-Prompts). Native-Aufrufe
   wären 404 — toter Code.
   - aiMedia-Case aus DeckEditorView.CreateMode, ModePicker auf
     3 Optionen (Leer / KI / CSV)
   - AIMediaFormSections, MediaFileRow, mediaPickers, thumbnail,
     ingestPhotoItems, handlePDFImport raus
   - generateDeckFromMedia + makeFromImageMultipartBody raus
   - GenerationMediaFile-Struct + PhotosUI-Import + PlatformImage-
     typealias raus
   - NSPhotoLibraryUsageDescription aus project.yml entfernt (es gibt
     keinen Photo-Library-Zugriff mehr)
   - maxMediaFiles/maxImageBytes/maxPDFBytes + inferImageMimeType +
     imageExtension aus DeckEditorHelpers raus

3. ζ-1 Offline-Sync
   Konzept in docs/OFFLINE_SYNC.md. Server-authoritative-FSRS bleibt —
   kein lokales FSRS, nur Snapshot-Modell.
   - Neue SwiftData-Models: CachedCard + CachedDueReview, beide mit
     userId/deckId-Indizes
   - ModelContainer um die zwei Models erweitert (additive Migration,
     sollte automatisch laufen — vor TestFlight verifizieren)
   - DueReview bekommt programmatischen init(review:card:) für die
     Cache-Rekonstruktion
   - DeckListStore.refresh() zieht Cards + Due-Reviews pro Deck
     parallel in einer TaskGroup; applyToCache in drei Helpers
     gesplittet (applyDecks / applyCards / applyDueReviews)
   - Karten: Upsert mit Orphan-Cleanup
   - Due-Reviews: voll ersetzt pro Refresh (Server-`due`-Zeiten
     ändern sich, Merge wäre falsch)
   - StudySession.start() fällt bei Netz-Fehler auf
     CachedDueReview-Snapshot zurück, setzt isOfflineSession-Flag
   - StudySessionView zeigt offline-Banner und am Ende der Session
     einen Hinweis „Weitere Karten erst nach Verbindung verfügbar"
   - AccountView.wipeLocalCache(): DSGVO-Wipe vor signOut() und nach
     deleteAccount → CachedDeck + CachedCard + CachedDueReview +
     PendingGrade werden gelöscht

Plus: Keychain-Test in WordeckNativeTests.swift fix — erwartete
"ev.mana.wordeck", muss seit Cross-App-SSO-Commit 19fee75
ManaSharedKeychainGroup nutzen. Auf Konstant-Reference umgestellt,
damit's nicht wieder driftet.

Verifikation:
- xcodebuild iOS-Simulator: BUILD SUCCEEDED
- swiftlint --strict: 0 violations in 68 files
- swiftformat: clean
- 37/37 Tests grün (inkl. fix-Keychain-Test)
- macOS-Build scheitert an pre-existing .topBarTrailing in
  StudySessionView (iOS-only API seit 2026-05-13, nicht durch
  diesen Commit verursacht)

Pflicht-Verifikation vor TestFlight (in PLAN.md verewigt):
- SwiftData-Migration auf Bestandsbuilder
- Offline-Endurance (50+ Karten Flugmodus)
- Logout-Wipe mit Account-Switch
- Cross-Check Web ↔ Native nach Offline-Grade

Diff: 35 files, +869 / -1622, netto ~−750 LOC.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-18 22:06:41 +02:00
devlog refactor(big-bang): cards-native → wordeck-native 2026-05-17 23:10:42 +02:00
docs feat(offline): text-only Cleanup + ζ-1 Offline-Sync 2026-05-18 22:06:41 +02:00
scripts v0.8.0 — Phase β-7 App-Store-Vorbereitung 2026-05-13 01:13:27 +02:00
ShareExtension feat(auth): Cross-App-SSO via shared Keychain-Group ev.mana.session 2026-05-18 16:32:09 +02:00
Sources feat(offline): text-only Cleanup + ζ-1 Offline-Sync 2026-05-18 22:06:41 +02:00
Tests feat(offline): text-only Cleanup + ζ-1 Offline-Sync 2026-05-18 22:06:41 +02:00
Widgets/WordeckWidget feat(auth): Cross-App-SSO via shared Keychain-Group ev.mana.session 2026-05-18 16:32:09 +02:00
.gitignore chore: build/-Verzeichnis aus Repo entfernen + gitignore 2026-05-17 23:44:55 +02:00
.swiftformat v0.1.0 — Phase β-0 Setup 2026-05-12 19:29:45 +02:00
.swiftlint.yml chore(lint): SwiftLint-Config + 0-Warnings-Pass + Swift-6-Concurrency-Fixes 2026-05-14 02:04:29 +02:00
CLAUDE.md refactor(big-bang): cards-native → wordeck-native 2026-05-17 23:10:42 +02:00
PLAN.md feat(offline): text-only Cleanup + ζ-1 Offline-Sync 2026-05-18 22:06:41 +02:00
project.yml feat(offline): text-only Cleanup + ζ-1 Offline-Sync 2026-05-18 22:06:41 +02:00
README.md refactor(big-bang): cards-native → wordeck-native 2026-05-17 23:10:42 +02:00

README.md

wordeck-native

Native SwiftUI-Universal-App (iOS / iPadOS / macOS) für Wordeck — die Spaced-Repetition-Karten-App des Vereins mana e.V.

Web-App-Parität. Die existierende Web-App auf wordeck.com ist Funktions- und Verhaltens-Referenz. Native bringt kein neues Produkt, sondern die App in einer Form, die iOS-Hardware besser nutzt.

Status

Phase β-0 — Setup. Leerer Build, Login funktioniert, Wordeck-API- Reachability-Check. Vollständiger Phasen-Plan in ../mana/docs/playbooks/CARDS_NATIVE_GREENFIELD.md.

                       HTTPS/JWT      ┌──────────────────┐
   cards-api          ◄─────────────  │ wordeck-native     │  SwiftUI
   api.wordeck.com              │ ev.mana.wordeck    │  WidgetKit (β-6)
                                      └──────────────────┘
                                               │
              ┌─────────────────────────────────────────┐
              ▼                                         ▼
   ManaCore (Auth, Transport)         ManaTokens (Designwerte)
   git.mana.how/till/mana-swift-core v1.0.0+

Lokal entwickeln

xcodegen generate
open WordeckNative.xcodeproj      # iPhone-17-Simulator

Konventionen, Invarianten, Phasen-Disziplin: CLAUDE.md.