docs: Uebergabe und README sagen nicht mehr, dass es kein Xcode gibt
Die wichtigste Aussage der Uebergabe war ueberholt: auf dieser Maschine liegt Xcode 27, Stufe 1 ist gebaut, getestet und im Simulator gestartet. Wer das nicht weiss, schreibt weiter blind und hinterlaesst dem Nutzer Fehler. Dazu neu festgehalten: der Befehl nach jeder neuen Datei (xcodegen generate), was beim Bauen auffiel (nur Swift 5, nicht Swift 6), und der naechste Stolperstein - App Transport Security laesst nur https zu, auch kein http://localhost. Ueber die Verbindung geht die Geraetemarke, ein Vollzugang; die Ausnahme ist deshalb eine Entscheidung des Nutzers, keine Nebensache. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Guido
Claude Opus 5
+49
-26
@@ -6,7 +6,7 @@ haben: was entschieden ist, was fertig ist, was als Nächstes dran ist, und was
|
||||
ich über das Backend herausgefunden habe. Lies sie ganz, bevor du anfängst —
|
||||
die Abschnitte „Was das Backend vorgibt" und „Fallen" ersparen dir Tage.
|
||||
|
||||
Stand: 20.10.2026, Commit `6b86a6b`. Alles committet und gepusht.
|
||||
Stand: 21.10.2026, Commit `ffe1870`. Alles committet und gepusht.
|
||||
|
||||
---
|
||||
|
||||
@@ -21,15 +21,23 @@ native iOS-App in `ios/`, die sich über eine eingegebene Server-Adresse (wie
|
||||
Dashboard, Arbeitsliste, Kategorien, Tags, Einstellungen, Bankabruf und der
|
||||
volle CSV-Import.
|
||||
|
||||
### Die wichtigste Rahmenbedingung
|
||||
### Die Rahmenbedingung, die es nicht mehr gibt
|
||||
|
||||
Auf der Maschine, auf der der Code entsteht, **gibt es kein Xcode**. Der Swift-
|
||||
Code wird blind geschrieben und nie übersetzt. Der Nutzer legt das Projekt an,
|
||||
übersetzt und meldet die Fehler zurück.
|
||||
Bis zum 21.10.2026 stand hier: es gibt kein Xcode, der Swift-Code wird blind
|
||||
geschrieben und nie übersetzt. **Das gilt nicht mehr.** Auf dieser Maschine
|
||||
liegt Xcode 27 mit Simulatoren für iOS 26.5 und 27, und `ios/project.yml`
|
||||
erzeugt das Projekt. Übersetzen, Tests und Starten im Simulator gehen hier
|
||||
direkt:
|
||||
|
||||
Daraus folgt die Arbeitsweise: **kleine Stufen, jede für sich übersetzbar.**
|
||||
Nicht zehntausend Zeilen schreiben und dann einen Berg Fehlermeldungen
|
||||
hinterlassen. Nach jeder Stufe übersetzt der Nutzer.
|
||||
```
|
||||
cd ios && xcodegen generate # nach jeder neuen Datei
|
||||
xcodebuild -project Certain.xcodeproj -scheme Certain \
|
||||
-destination 'platform=iOS Simulator,name=iPhone 17 Pro' build # oder test
|
||||
```
|
||||
|
||||
**Übersetze nach jeder Stufe selbst, statt dem Nutzer Fehler zu hinterlassen.**
|
||||
Die kleinen Stufen bleiben trotzdem richtig — nicht wegen der Fehlersuche,
|
||||
sondern damit jede Stufe für sich benutzbar ist.
|
||||
|
||||
---
|
||||
|
||||
@@ -44,7 +52,7 @@ Alle schon gefallen. **Nicht erneut fragen.**
|
||||
| Zusätzlicher Umfang | Arbeitsliste/Eingang, Kategorien und Tags, Einstellungen, Bankabruf anstossen |
|
||||
| Dashboard | Feste iOS-Ansicht, kein Raster |
|
||||
| iOS-Mindestversion | **iOS 26** |
|
||||
| Ablieferung | Flache Ordner unter `ios/`, der Nutzer legt das Xcode-Projekt an |
|
||||
| Ablieferung | Flache Ordner unter `ios/`; das Projekt entsteht seit dem 21.10. aus `project.yml` |
|
||||
| Anmeldung | App-Token (im Backend ergänzt, siehe unten) |
|
||||
| Erweiterungen | Teilen-Menü für Dateien, Kurzbefehle/Siri |
|
||||
| Sprachen | Deutsch **und** Englisch |
|
||||
@@ -224,7 +232,8 @@ sie beide Richtungen anbietet. Nötig für Stufe 3.
|
||||
| `Konten/` | `KontenListe` — die erste Fachansicht |
|
||||
| `Einstellungen/` | Platzhalter: zeigt den Zugang und lässt abmelden |
|
||||
| `Texte/` | `de.lproj` und `en.lproj`, zeilengleich |
|
||||
| `Tests/` | `GrundlagenTests` — reine Logik, Swift Testing |
|
||||
| `Tests/` | `GrundlagenTests` — reine Logik, Swift Testing, 28 Stück |
|
||||
| `project.yml` | XcodeGen-Spezifikation, erzeugt `Certain.xcodeproj` |
|
||||
|
||||
### Wie die Anmeldung abläuft
|
||||
|
||||
@@ -249,11 +258,17 @@ Wegwerf-Datenbank, Felder flach ausgeben, mit den `CodingKeys` vergleichen.
|
||||
(Das Passwort der Dev-Datenbank unter `backend/data/app.db` ist unbekannt —
|
||||
nicht raten, eine frische Testdatenbank nehmen.)
|
||||
|
||||
### Was nicht geprüft ist
|
||||
### Dass es übersetzt, ist inzwischen geprüft
|
||||
|
||||
**Ob es übersetzt.** Der Nutzer hatte Stufe 1 beim Schreiben dieser Datei noch
|
||||
nicht gebaut. Rechne damit, dass seine erste Rückmeldung Fehlermeldungen sind —
|
||||
das ist eingeplant und kein Rückschlag.
|
||||
Am 21.10.2026 gebaut, getestet und gestartet (Commit `ffe1870`). Genau **ein**
|
||||
Übersetzungsfehler in 2600 blind geschriebenen Zeilen: der Vorgabewert
|
||||
`[String: String] = []` in `CertainClient.schickeDatei` musste `[:]` heissen.
|
||||
Sonst keine Fehler, keine Warnung im eigenen Code. Die 28 Tests laufen durch,
|
||||
die App startet im Simulator bei der Serverabfrage.
|
||||
|
||||
**Noch nicht geprüft: der Weg gegen ein echtes Backend.** Anmelden, zweiter
|
||||
Faktor, Marke anlegen, Kontenliste — das lief bisher nur gegen die Modelle,
|
||||
nicht gegen einen laufenden Server. Siehe „Klartext-HTTP" unten.
|
||||
|
||||
---
|
||||
|
||||
@@ -306,20 +321,26 @@ Einwand und will den vollen Import trotzdem.
|
||||
|
||||
## 7. Fallen und Arbeitsweise
|
||||
|
||||
### Beim Übersetzen am ehesten verdächtig
|
||||
### Klartext-HTTP — der nächste Stolperstein
|
||||
|
||||
Nach abnehmender Wahrscheinlichkeit:
|
||||
Das Projekt läuft mit der Voreinstellung von App Transport Security, also
|
||||
**nur https**. Ein selbstgehosteter Server im Heimnetz unter `http://…` wird
|
||||
abgewiesen, und `http://localhost` beim Entwickeln ebenso — obwohl
|
||||
`ServerAnsicht` http ausdrücklich zulässt und ein Test das festhält
|
||||
(„http bleibt http"). Wer gegen ein lokales Backend prüfen will, braucht
|
||||
in `project.yml` eine ATS-Ausnahme. Das ist eine Sicherheitsentscheidung des
|
||||
Nutzers: über Klartext geht die Gerätemarke, ein Vollzugang, mit jeder
|
||||
Anfrage mit.
|
||||
|
||||
1. **`@testable import Certain`** in `Tests/GrundlagenTests.swift` muss auf den
|
||||
Namen des App-Ziels zeigen.
|
||||
2. **`Lader` ist eine generische `@Observable`-Klasse** — die ungewöhnlichste
|
||||
Konstruktion im Code. Wird bisher nur in `KontenListe` benutzt.
|
||||
3. **Nebenläufigkeit:** `AppZustand` ist `@MainActor`, `CertainClient` ein
|
||||
Actor. An den Übergängen kann es unter strikter Prüfung Warnungen setzen.
|
||||
4. **`Tab` und `.tabViewStyle(.sidebarAdaptable)`** setzen iOS 18 voraus — bei
|
||||
iOS 26 als Mindestversion kein Problem.
|
||||
5. Die Tests nutzen **Swift Testing** (`import Testing`, `@Test`, `#expect`),
|
||||
nicht XCTest.
|
||||
### Was beim Übersetzen auffiel
|
||||
|
||||
Alles, was hier als verdächtig stand, hat gehalten: `Lader` als generische
|
||||
`@Observable`-Klasse, der `@MainActor`/Actor-Übergang zwischen `AppZustand`
|
||||
und `CertainClient`, `Tab` mit `.tabViewStyle(.sidebarAdaptable)`, Swift
|
||||
Testing statt XCTest. Eine Einschränkung: Das Projekt baut in **Sprachfassung
|
||||
Swift 5**. Unter Swift 6 greift die strikte Nebenläufigkeitsprüfung, und die
|
||||
Übergänge sind darauf nicht geschrieben — wer umstellen will, rechnet mit
|
||||
Arbeit an genau diesen Stellen.
|
||||
|
||||
### Schreibende Aufrufe mit Query statt Körper
|
||||
|
||||
@@ -336,6 +357,8 @@ Leicht zu übersehen, das Backend macht es an mehreren Stellen:
|
||||
Commit. Fertige Arbeit wird committet und gepusht, ohne Rückfrage.
|
||||
- **Kommentare erklären das Warum**, nicht das Was — und zwar das, was der Code
|
||||
nicht zeigen kann. Das ganze Projekt ist so geschrieben; halte es durch.
|
||||
- **Neue Swift-Datei?** Danach `cd ios && xcodegen generate`. Die Ordner stehen
|
||||
einzeln in `project.yml`; ein neuer Ordner will dort eine Zeile.
|
||||
- **Tests**: `cd backend && ./.venv/Scripts/python.exe -m pytest tests/ -q`
|
||||
(Python 3.12 im venv; das System-Python kann nicht bauen). Dauert rund zwei
|
||||
Minuten — im Hintergrund laufen lassen.
|
||||
|
||||
Reference in New Issue
Block a user