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>
This commit is contained in:
Scarriffle
2026-10-03 19:38:27 +02:00
co-authored by Claude Opus 5
parent f98b995050
commit a7cf6c5def
390 changed files with 2078 additions and 2069 deletions
@@ -0,0 +1,240 @@
import Foundation
import MediaKit
import Testing
@testable import FlaroDownloads
/// Baut einen Eintrag im gewünschten Zustand, ohne Datenbank.
@MainActor
private func item(
_ key: String,
state: DownloadState = .completed,
watchedAgo: Duration? = nil,
series: String? = nil
) -> DownloadItem {
let item = DownloadItem(
ratingKey: key,
title: "Titel \(key)",
sourceURLString: "http://server/\(key)",
state: state,
seriesKey: series
)
if let watchedAgo {
item.watchedAt = Date().addingTimeInterval(-watchedAgo.seconds)
}
return item
}
@MainActor
@Suite("Download-Regeln")
struct DownloadRulesTests {
// MARK: - Automatisches Löschen
@Test("Ohne Regel wird nichts gelöscht")
func disabledRulesDeleteNothing() {
// Die wichtigste Zusicherung im ganzen Regelwerk: wer nichts
// eingestellt hat, verliert nichts.
let items = [item("1", watchedAgo: .afterOneWeek)]
#expect(DownloadRules.disabled.itemsToDelete(from: items).isEmpty)
}
@Test("Ungesehene Titel werden nie gelöscht")
func unwatchedIsNeverDeleted() {
let rules = DownloadRules(deleteWatchedAfter: .immediately)
let items = [item("1"), item("2"), item("3")]
#expect(rules.itemsToDelete(from: items).isEmpty)
}
@Test("Nach Ablauf der Frist wird gelöscht")
func deletesAfterGracePeriod() {
let rules = DownloadRules(deleteWatchedAfter: .afterOneDay)
let items = [
item("alt", watchedAgo: .afterOneWeek),
item("frisch", watchedAgo: .seconds(60)),
]
let doomed = rules.itemsToDelete(from: items).map(\.ratingKey)
#expect(doomed == ["alt"])
}
@Test("Die Frist schützt frisch Gesehenes")
func gracePeriodProtectsRecent() {
// Wer eine Folge zu Ende sieht und gleich noch einmal die letzte
// Szene sucht, soll sie nicht schon verloren haben.
let rules = DownloadRules(deleteWatchedAfter: .afterOneDay)
let items = [item("1", watchedAgo: .seconds(3_600))]
#expect(rules.itemsToDelete(from: items).isEmpty)
}
@Test("Unfertige Downloads werden nicht gelöscht")
func incompleteDownloadsSurvive() {
// Ein laufender Download hat nichts, was gesehen worden sein könnte —
// ein alter watchedAt-Wert aus einem früheren Durchlauf darf ihn
// nicht abräumen.
let rules = DownloadRules(deleteWatchedAfter: .immediately)
let running = item("1", state: .downloading, watchedAgo: .afterOneWeek)
#expect(rules.itemsToDelete(from: [running]).isEmpty)
}
// MARK: - Vorrat an Folgen
@Test("Ohne Regel wird nichts nachgeladen")
func noRefillWithoutRule() {
#expect(DownloadRules.disabled.seriesNeedingRefill(in: [item("1", series: "s")]).isEmpty)
}
@Test("Ein leerer Vorrat verlangt die volle Zahl")
func emptyStockNeedsFullCount() {
let rules = DownloadRules(keepUnwatchedEpisodes: 3)
#expect(rules.missingEpisodeCount(forSeries: "s", in: []) == 3)
}
@Test("Gesehene Folgen zählen nicht zum Vorrat")
func watchedEpisodesDoNotCount() {
// Sonst bliebe der Vorrat bei drei gesehenen Folgen stehen und es käme
// nie etwas Neues nach — genau das Gegenteil des Gewünschten.
let rules = DownloadRules(keepUnwatchedEpisodes: 3)
let items = [
item("1", watchedAgo: .seconds(10), series: "s"),
item("2", watchedAgo: .seconds(10), series: "s"),
item("3", series: "s"),
]
#expect(rules.missingEpisodeCount(forSeries: "s", in: items) == 2)
}
@Test("Wartende Downloads zählen zum Vorrat")
func queuedEpisodesCount() {
// Sonst würde bei jedem Durchlauf erneut nachgelegt, bis die ganze
// Serie auf dem Gerät liegt.
let rules = DownloadRules(keepUnwatchedEpisodes: 3)
let items = [
item("1", state: .completed, series: "s"),
item("2", state: .queued, series: "s"),
item("3", state: .downloading, series: "s"),
]
#expect(rules.missingEpisodeCount(forSeries: "s", in: items) == 0)
}
@Test("Gescheiterte Downloads zählen nicht zum Vorrat")
func failedEpisodesDoNotCount() {
let rules = DownloadRules(keepUnwatchedEpisodes: 2)
let items = [
item("1", state: .completed, series: "s"),
item("2", state: .failed, series: "s"),
]
#expect(rules.missingEpisodeCount(forSeries: "s", in: items) == 1)
}
@Test("Ein voller Vorrat verlangt nichts")
func fullStockNeedsNothing() {
let rules = DownloadRules(keepUnwatchedEpisodes: 2)
let items = [item("1", series: "s"), item("2", series: "s"), item("3", series: "s")]
#expect(rules.missingEpisodeCount(forSeries: "s", in: items) == 0)
}
@Test("Serien werden getrennt gezählt")
func seriesAreCountedSeparately() {
let rules = DownloadRules(keepUnwatchedEpisodes: 2)
let items = [
item("a1", series: "a"),
item("a2", series: "a"),
item("b1", series: "b"),
]
let refill = rules.seriesNeedingRefill(in: items)
#expect(refill["a"] == nil)
#expect(refill["b"] == 1)
}
@Test("Filme ohne Serie lösen kein Nachladen aus")
func moviesDoNotTriggerRefill() {
let rules = DownloadRules(keepUnwatchedEpisodes: 3)
#expect(rules.seriesNeedingRefill(in: [item("1"), item("2")]).isEmpty)
}
}
@MainActor
@Suite("Plausibilität fertiger Downloads")
struct DownloadPlausibilityTests {
@Test("Eine Fehlerseite geht nicht als Film durch")
func tinyFileIsRejected() {
// Der Fall aus der Praxis: 873 MB angekündigt, in einer Sekunde
// „fertig". Angekommen war eine HTML-Fehlerseite, und weil die
// empfangene Größe auch als erwartete notiert wurde, stand die
// Anzeige auf hundert Prozent.
#expect(DownloadCoordinator.implausibility(
written: 2_048, expected: 873_000_000, announced: true
) != nil)
}
@Test("Auch ohne angekündigte Größe fällt eine Fehlerseite auf")
func tinyFileWithoutExpectation() {
// Beim umgerechneten Download kennt der Server die Endgröße vorab
// nicht — die Untergrenze muss deshalb allein tragen.
#expect(DownloadCoordinator.implausibility(
written: 900, expected: 0, announced: false
) != nil)
}
@Test("Eine abgebrochene Übertragung fällt auf")
func truncatedTransferIsRejected() {
#expect(DownloadCoordinator.implausibility(
written: 200_000_000, expected: 873_000_000, announced: false
) != nil)
}
@Test("Bei sechzig Prozent einer angekündigten Größe ist die Datei kaputt")
func truncatedAtSixtyPercentIsRejected() {
// **Der Fehler, der diese Unterscheidung nötig gemacht hat.** Hier
// galt dieselbe Hälfte-Regel wie für geschätzte Größen, und eine bei
// sechzig Prozent abgerissene Datei kam durch: Haken dran, und beim
// Abspielen brach sie mittendrin ab. Gemeldet wurde das als
// „plötzlich war er fertig".
#expect(DownloadCoordinator.implausibility(
written: 1_800_000_000, expected: 3_000_000_000, announced: true
) != nil)
}
@Test("Dieselben sechzig Prozent einer Schätzung gehen durch")
func truncatedAtSixtyPercentOfEstimatePasses() {
// Gleiche Zahlen, andere Herkunft: hochgerechnet aus Bitrate und
// Dauer. Dort ist eine Abweichung nach unten normal, und streng zu
// prüfen hieße, gültige Downloads zu verwerfen.
#expect(DownloadCoordinator.implausibility(
written: 1_800_000_000, expected: 3_000_000_000, announced: false
) == nil)
}
@Test("Eine vollständige Datei geht durch")
func completeFilePasses() {
#expect(DownloadCoordinator.implausibility(
written: 873_000_000, expected: 873_000_000, announced: true
) == nil)
}
@Test("Kleinere Abweichungen sind erlaubt, solange die Größe geschätzt ist")
func smallDeviationPasses() {
// Der Transcoder arbeitet mit variabler Bitrate und trifft die
// geschätzte Größe nie genau.
#expect(DownloadCoordinator.implausibility(
written: 800_000_000, expected: 873_000_000, announced: false
) == nil)
}
@Test("Dieselbe Abweichung bei angekündigter Größe ist ein Abriss")
func smallDeviationOfAnnouncedSizeIsRejected() {
// Hat der Server die Größe genannt, gibt es keine erklärbare
// Abweichung: was fehlt, fehlt.
#expect(DownloadCoordinator.implausibility(
written: 800_000_000, expected: 873_000_000, announced: true
) != nil)
}
@Test("Ohne Erwartung geht eine normale Datei durch")
func noExpectationPasses() {
#expect(DownloadCoordinator.implausibility(
written: 500_000_000, expected: 0, announced: false
) == nil)
}
}