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
+134
View File
@@ -0,0 +1,134 @@
namespace Flaro.Api.Endpoints;
// Was über die Leitung geht. Bewusst eigene Typen und nicht die der Domäne:
// sonst wandert jede Umbenennung im Datenmodell ungefragt in die Schnittstelle
// und bricht Clients, die niemand mehr aktualisiert.
public sealed record SystemInfo(
string Version, bool NeedsSetup, IReadOnlyList<AttributionResponse> Attributions);
public sealed record SetupRequest(string UserName, string Password);
public sealed record LoginRequest(string UserName, string Password, string DeviceName, string DeviceId);
public sealed record AuthenticatedUser(Guid Id, string UserName, bool IsAdministrator);
public sealed record LoginResponse(string Token, AuthenticatedUser User);
public sealed record CodeRequest(string DeviceName, string DeviceId);
/// <summary>Was der Fernseher nach dem Anfordern bekommt.</summary>
///
/// <remarks>
/// Der <c>Handle</c> ist das Geheimnis und wird <b>nicht</b> angezeigt — der
/// <c>Code</c> ist das, was auf dem Bildschirm steht.
/// </remarks>
public sealed record CodeResponse(string Code, string Handle, DateTimeOffset ExpiresAt);
public sealed record CodeState(string State, LoginResponse? Login);
public sealed record CreateUserRequest(string UserName, string Password, bool IsAdministrator);
public sealed record LibraryResponse(Guid Id, string Name, string Kind, string Path);
public sealed record CreateLibraryRequest(string Name, string Kind, string Path);
// --- Stufe 2: Bibliothek -------------------------------------------------
public sealed record ScanProblem(string Path, string Reason);
public sealed record ScanStatus(
string State,
DateTimeOffset? StartedAt,
DateTimeOffset? FinishedAt,
int? FilesFound,
int? Added,
int? Updated,
int? Removed,
int? Unrecognised,
int? Probed,
IReadOnlyList<ScanProblem>? Problems,
string? Error,
MetadataProgress? Metadata);
/// <summary>Was das Nachschlagen bei der Metadatenquelle ergeben hat.</summary>
public sealed record MetadataProgress(
int MoviesMatched, int SeriesMatched, int EpisodesMatched, bool Skipped, string? Error);
/// <summary>Eine Spur in einer Datei.</summary>
public sealed record MediaStreamResponse(
int Index, string Kind, string? Codec, string? Language, string? Title,
bool IsDefault, bool IsForced, int? Channels, int? Width, int? Height);
/// <summary>Eine Datei hinter einem Titel — eine Fassung also.</summary>
///
/// <remarks>
/// <b>Nur der Dateiname, nicht der Pfad.</b> Der Pfad verriete jedem
/// Angemeldeten den Aufbau des Servers, und gebraucht wird er nirgends: die
/// App spricht Dateien über ihre Kennung an. Zum Unterscheiden zweier
/// Fassungen genügt der Name.
/// </remarks>
public sealed record MediaFileResponse(
Guid Id, string FileName, long SizeBytes, string? Container, double? DurationSeconds,
IReadOnlyList<MediaStreamResponse> Streams);
public sealed record MovieResponse(
Guid Id, string Title, int? Year, string? Overview,
string? PosterImage, string? BackdropImage,
IReadOnlyList<MediaFileResponse> Files);
public sealed record SeriesResponse(
Guid Id, string Title, int? Year, string? Overview,
string? PosterImage, string? BackdropImage,
int EpisodeCount, IReadOnlyList<int> Seasons);
public sealed record EpisodeResponse(
Guid Id, int Season, int Episode, string? Title, string? Overview, string? StillImage,
IReadOnlyList<MediaFileResponse> Files);
public sealed record Page<T>(IReadOnlyList<T> Items, int Total);
public sealed record MetadataSettingsResponse(
bool HasApiKey, string Language, bool UsingProjectKey);
/// <summary>Was ein Client über der Mediathek anzeigen muss.</summary>
///
/// <remarks>
/// <b>Bedingung, nicht Höflichkeit.</b> TMDB verlangt in seinen
/// Nutzungsbedingungen, dass das Logo gezeigt wird und dieser Satz dasteht.
/// Der Server liefert beides, damit kein Client es abtippen muss — und keiner
/// es vergisst.
/// </remarks>
public sealed record AttributionResponse(string Text, string LogoUrl, string Url);
public sealed record MetadataSettingsRequest(string? ApiKey, string? Language);
// --- Stufe 3: Ausliefern -------------------------------------------------
/// <summary>Was mit einer Datei geschehen wird, bevor sie hinausgeht.</summary>
///
/// <remarks>
/// <b>Damit vorher feststeht, was man bekommt.</b> Drei Gigabyte
/// herunterzuladen und erst danach zu merken, dass die Untertitel fehlen oder
/// die falsche Tonspur drin ist, war der Anlass für dieses ganze Projekt.
/// </remarks>
public sealed record DeliveryInfo(
string Method,
IReadOnlyList<string> Reasons,
IReadOnlyList<int> AudioToEncode,
IReadOnlyList<int> SubtitlesDropped,
string PackageState,
double Progress,
string? Error);
// --- Zuordnung korrigieren -----------------------------------------------
/// <summary>Ein Vorschlag, aus dem gewählt werden kann.</summary>
public sealed record MatchCandidate(
int TmdbId, string Title, int? Year, string? Overview, string? PosterUrl);
public sealed record ApplyMatchRequest(int TmdbId);
/// <summary>Wie die Zuordnung jetzt aussieht.</summary>
public sealed record MatchState(
int? TmdbId, string? ImdbId, bool Locked, string Title, int? Year);