Halo heisst ab hier Flaro — die Marke stand im Weg

Der Upload zu App Store Connect scheiterte am Namen. „Halo" ist eine
eingetragene Marke von Microsoft; im App Store heisst zwar keine App exakt
so, aber reservierte und markenrechtlich belegte Namen tauchen in keiner
Suche auf. Der einzige verlässliche Test war die Eingabe dort, und die ging
daneben.

**Der Name wurde diesmal vorher geprüft.** Zwanzig Kandidaten gegen den
deutschen und amerikanischen App Store, auf exakte Treffer und auf ähnliche
Namen. „Kavo" wäre dieselbe Wand gewesen — exakt belegt in beiden Stores, in
Deutschland von KaVo Dental GmbH. „Flare" ist mit 42 ähnlichen Apps je Store
der am dichtesten besetzte Name der ganzen Runde. **Flaro** ist in beiden
frei und liest sich als eigenes Wort, nicht als Flare mit Tippfehler.

Das bleibt eine Store-Suche und keine Markenrecherche — reservierte Namen
ohne veröffentlichte App sieht sie nicht. Aber es ist mehr Prüfung, als beim
letzten Mal stattfand.

---

2160 Textvorkommen in 273 Dateien, 49 Pfade. Betroffen ist diesmal auch der
Server: `Flaro.Api`, `Flaro.Core`, `Flaro.Data`, `Flaro.Media`,
`Flaro.Metadata`, `FlaroContext`, `FlaroPaths`, `flaro.db`, die Variablen
`FLARO_DATA`, `FLARO_CACHE`, `FLARO_TRANSCODE`, `FLARO_WRITE_SIDECARS`, und
das Image.

**Vor dem Ersetzen geprüft**, ob „halo" irgendwo als Teil eines anderen
Wortes steckt — und ob es im TMDB-Token vorkommt. Tat es nicht; ein blindes
Ersetzen hätte den sonst zerlegt.

`docs/superpowers/specs/` bleibt wie beim letzten Mal unangetastet: datierte
Entwurfsdokumente sind ein Protokoll getroffener Entscheidungen. Das
Server-Dokument hat stattdessen einen Nachtrag bekommen, damit es niemanden
in die Irre führt.

**Die Bundle-ID wandert mit**, zum zweiten Mal an einem Tag:
`com.scarriffleservices.flaro`. Wer die vorige Fassung installiert hat, hat
jetzt zwei Karteileichen auf dem Gerät — beide löschen, dann ist Ruhe.

308 Server-Tests grün, 368 im Swift-Paket, null Warnungen. iOS und tvOS
bauen, das Image baut, und ein frischer Container läuft durch Einrichtung
und Anmeldung.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

FlaroTV/Views/Home/TVHomeView.swift

@@ -0,0 +1,148 @@
+import SwiftUI
+import FlaroDesign
+import MediaKit
+
+/// Die Startseite auf dem Fernseher.
+///
+/// **Dasselbe Modell wie am Telefon.** `HomeFeed` lädt, ordnet und lost den
+/// Aufmacher aus; hier steht nur, wie das aussieht. Der Unterschied ist die
+/// Bedienart, nicht der Inhalt.
+struct TVHomeView: View {
+    /// Wohin ein Link aus dem Regal führen soll.
+    ///
+    /// **Als Bindung von aussen**, nicht als eigener Zustand: das Regal
+    /// erreicht die Wurzel, der Navigationsstapel liegt hier. Einen zweiten
+    /// Stapel eine Ebene höher anzulegen, nur um ein Ziel durchzureichen,
+    /// hiesse zwei Stapel gleich zu halten.
+    @Binding var deepLinkTarget: MediaRoute?
+
+    @Environment(FlaroSession.self) private var session
+    @Environment(HomeLayoutSettings.self) private var layout
+    @Environment(PlaybackCoordinator.self) private var playback
+    @Environment(QuickPlay.self) private var quickPlay
+
+    @State private var feed = HomeFeed()
+    @State private var pfad = NavigationPath()
+    /// Welcher Titel gerade oben gross steht.
+    ///
+    /// **Der Fokus bestimmt ihn, nicht eine Uhr.** Am Telefon wechselt der
+    /// Aufmacher alle sieben Sekunden von selbst — dort blättert man ihn auch
+    /// mit dem Daumen. Vor einem Fernseher wäre ein Bild, das sich von allein
+    /// austauscht, während man es ansieht, eine Zumutung: man verliert den
+    /// Titel, den man gerade lesen wollte.
+    @State private var aufmacher: MediaItem?
+
+    var body: some View {
+        NavigationStack(path: $pfad) {
+            inhalt
+                .navigationDestination(for: MediaRoute.self) { route in
+                    TVDetailView(route: route)
+                }
+        }
+        .task(id: session.serverName) { await feed.load(from: session.backend) }
+        .onChange(of: deepLinkTarget) { _, neu in
+            guard let neu else { return }
+            pfad.append(neu)
+            deepLinkTarget = nil
+        }
+    }
+
+    @ViewBuilder
+    private var inhalt: some View {
+        switch feed.state {
+        case .loading:
+            ProgressView().frame(maxWidth: .infinity, maxHeight: .infinity)
+
+        case .failed(let meldung):
+            VStack(spacing: FlaroSpacing.regular) {
+                Text(meldung).font(.flaroBody).foregroundStyle(.white)
+                Button("action.retry") {
+                    Task { await feed.load(from: session.backend) }
+                }
+            }
+
+        case .loaded:
+            let reihen = feed.rows(for: layout)
+            if reihen.isEmpty && session.libraries.isEmpty {
+                Text("home.empty.title").font(.flaroRowHeader).foregroundStyle(.white)
+            } else {
+                seite(reihen: reihen)
+            }
+        }
+    }
+
+    private func seite(reihen: [MediaRowGroup]) -> some View {
+        ScrollView {
+            LazyVStack(alignment: .leading, spacing: FlaroSpacing.section) {
+                if let gezeigt = aufmacher ?? feed.heroItems(for: layout).first {
+                    TVHeroSection(
+                        item: gezeigt,
+                        onPlay: { spiele(gezeigt) },
+                        onDetails: { zeige(gezeigt) }
+                    )
+                    .frame(height: 720)
+                }
+
+                ForEach(reihen) { reihe in
+                    // **Der Fokus setzt den Aufmacher.** Wer durch „Zuletzt
+                    // hinzugefügt" wandert, sieht oben, was er gerade
+                    // anschaut — ohne irgendwo hindrücken zu müssen.
+                    TVMediaRow(
+                        row: reihe,
+                        onSelect: { spiele($0) },
+                        onFocus: { aufmacher = $0 }
+                    )
+                }
+            }
+            .padding(.bottom, FlaroSpacing.screenMargin)
+        }
+        .scrollIndicators(.never)
+        // **Bildfüllend, und der Rand steckt in `screenMargin`.** Der
+        // Aufmacher muss bis an die Bildschirmkante reichen; ein Bild, das
+        // achtzig Punkte davor aufhört, sieht nach Fehler aus.
+        .ignoresSafeArea()
+        // Als Überlagerung und nicht als letzte Zeile der Liste: dorthin
+        // müsste man erst an allen Reihen vorbeiscrollen, und wer nachsieht,
+        // warum das Regal leer ist, soll es sofort sehen.
+        .overlay(alignment: .bottom) { regalStatus }
+    }
+
+    /// Was das Regal über der App zuletzt bekommen hat.
+    ///
+    /// **Nur im Entwicklerbau.** Es gehört nicht in die fertige App — aber
+    /// solange das Regal leer bleibt, sieht man von aussen nicht, woran es
+    /// liegt: fehlende App-Gruppe, fehlende Datei und ein System, das nicht
+    /// fragt, sehen alle gleich aus. Diese Zeile unterscheidet sie.
+    @ViewBuilder
+    private var regalStatus: some View {
+        #if DEBUG
+        VStack(alignment: .leading, spacing: FlaroSpacing.tight) {
+            Text("topShelf.title")
+                .font(.flaroCaption)
+                .foregroundStyle(Color.flaroTextMuted)
+            Text(TopShelfWriter.status)
+                .font(.flaroCaption)
+                .foregroundStyle(Color.flaroTextSecondary)
+        }
+        .padding(.horizontal, FlaroSpacing.screenMargin)
+        .padding(.bottom, FlaroSpacing.regular)
+        .frame(maxWidth: .infinity, alignment: .leading)
+        .background(Color.black.opacity(0.6))
+        #endif
+    }
+
+    // MARK: - Was ein Druck auslöst
+
+    /// **Über QuickPlay, nicht unmittelbar.** Steht in der Reihe eine Serie —
+    /// und Jellyfins „Zuletzt hinzugefügt" liefert neue Folgen als ihre Serie
+    /// —, schickte der direkte Weg deren eigene Kennung an den Player, und der
+    /// scheiterte mit „keine abspielbare Datei". Eine Serie hat keine
+    /// Fassungen.
+    private func spiele(_ item: MediaItem) {
+        quickPlay.start(item, backend: session.backend, coordinator: playback)
+    }
+
+    private func zeige(_ item: MediaItem) {
+        pfad.append(MediaRoute(ratingKey: item.id, title: item.title))
+    }
+}