till/zitare-native
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Native SwiftUI-Universal-App (iOS / iPadOS / macOS) für Zitare — Hybrid (WKWebView + Widget + ShareExt + native Submit) unter ev.mana.zitare.
24 commits 1 branch 0 tags 560 KiB
Find a file
Till JS 61927d27a3 ζ-3.5: Offline-Submit-Queue mit SwiftData + Auto-Retry 
Bei Network-Failure landet der Quote-Draft jetzt in einer persistenten
SwiftData-Queue (\`PendingSubmission\`) statt im Error-Banner. Beim
nächsten App-Launch ODER beim Wechsel auf scenePhase.active wird der
Flush automatisch versucht.

Retry-Policy:
- 5xx oder Transport-Failure (NSURLErrorDomain) → in Queue, Retry
- 4xx mit code (validation_failed, duplicate, unauthorized) →
  permanenter Fehler, kein Retry (User-Aktion nötig)
- Hard-Limit 50 Retries pro Entry, danach pausiert

App-Group-Store \`submissions.store\` (parallel zu snapshot.store) im
\`group.ev.mana.zitare\`-Container. Fallback auf In-Memory falls
Disk-Init scheitert (App-Group noch nicht aktiviert im Apple-Dev-Portal).

UI-Pieces:
- Pending-Banner zeigt Queue-Tiefe wenn > 0
- Queued-Banner nach erfolgreichem Enqueue
- Form-Reset nach Enqueue (User sieht: "weg, kommt nach")
- onChange(scenePhase) → Auto-Flush bei Foreground
- ZitareNativeApp.task: Flush am Launch

Files:
- Sources/Core/Submit/PendingSubmissionModel.swift (neu, @Model)
- Sources/Core/Submit/SubmissionQueue.swift (neu, @Observable @MainActor)
- Sources/App/ZitareNativeApp.swift: Container-Init + environment-Wiring
- Sources/Features/Submit/SubmitQuoteView.swift: enqueue + flush + banners

iOS + macOS BUILD SUCCEEDED.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-19 16:22:52 +02:00
devlog devlog: 2 Tage geschrieben (ζ-0 + ζ-1 + Launch-Flash-Fix) 2026-05-15 22:22:49 +02:00
docs docs: Cloudflare-TODO (DNS-CNAME + CNAME-Cleanup) + PLAN.md externe Blocker 2026-05-14 20:52:13 +02:00
scripts icon: vereinfachte Anführungszeichen-Glyphe als Platzhalter 2026-05-14 21:02:17 +02:00
ShareExtension ζ-0 Setup: Repo-Skelett, iOS-Build grün, Healthz live 2026-05-14 12:15:22 +02:00
Sources ζ-3.5: Offline-Submit-Queue mit SwiftData + Auto-Retry 2026-05-19 16:22:52 +02:00
Tests ζ-2 native: SwiftData-Snapshot-Cache + DailyQuoteWidget 2026-05-14 13:16:05 +02:00
Widgets/ZitareWidget feat(widget): #Preview-Macros fuer Small + Large ergaenzt 2026-05-17 23:46:24 +02:00
.gitignore ζ-0 Setup: Repo-Skelett, iOS-Build grün, Healthz live 2026-05-14 12:15:22 +02:00
.swiftformat ζ-0 Setup: Repo-Skelett, iOS-Build grün, Healthz live 2026-05-14 12:15:22 +02:00
.swiftlint.yml ζ-0 Setup: Repo-Skelett, iOS-Build grün, Healthz live 2026-05-14 12:15:22 +02:00
CLAUDE.md ζ-0 Setup: Repo-Skelett, iOS-Build grün, Healthz live 2026-05-14 12:15:22 +02:00
PLAN.md docs: Cloudflare-TODO (DNS-CNAME + CNAME-Cleanup) + PLAN.md externe Blocker 2026-05-14 20:52:13 +02:00
project.yml fix(account): Anmelden-Button + ManaAuthGate-Wiring 2026-05-19 15:28:08 +02:00
README.md ζ-0 Setup: Repo-Skelett, iOS-Build grün, Healthz live 2026-05-14 12:15:22 +02:00

README.md

zitare-native

Native SwiftUI-Universal-App (iOS / iPadOS / macOS) für Zitare, den öffentlichen Zitat-Korpus des Vereins mana e.V.

Hybrid-Architektur. Lese-Surfaces laufen im WKWebView gegen zitare.com. Native-Code ist nur dort, wo Native einen Distributions-Hebel hat: Home-Screen-Widget, ShareExtension, Spotlight-Index und Submit-View. Anders als cards-native, memoro-native und manaspur-native (alle „pure SwiftUI") — die Begründung steht im Playbook.

Status

Phase ζ-0 — Setup. Repo-Skelett, project.yml, leerer Build. Vollständiger 7-Phasen-Plan in ../mana/docs/playbooks/ZITARE_NATIVE_GREENFIELD.md. Phasen-Tracking in PLAN.md.

Lokal entwickeln

brew install xcodegen swiftformat swiftlint
xcodegen generate
open ZitareNative.xcodeproj

Voraussetzung: ../mana-swift-core/ und ../mana-swift-ui/ als Schwester-Verzeichnisse (Package-Dependencies via path:).

Bundle-IDs

Target Bundle
App ev.mana.zitare
Widget Extension ev.mana.zitare.widget
Share Extension ev.mana.zitare.share
App Group group.ev.mana.zitare

Cross-Refs