# ServiceDefinition: seerr
# Source of truth: spec docs/13-service-catalog.md row 5; docs/15-identity-and-access.md;
# docs/03-networking-isolation-and-egress.md (explicit allow rules).
# public | egress internet | config on Longhorn | auth: native (Plex accounts) |
# seerr -> sonarr:8989, seerr -> radarr:7878, seerr -> plex:32400.
#
# Seerr is the media request UI (Overseerr): users request titles, it hands them to the arr
# stack and reflects library state from Plex. It is publicly exposed (edge port-forward + public
# DNS, docs/09) and authenticates with Plex's own account system — a DOCUMENTED SSO exception
# (docs/13/15; R-IDP-02): NOT Keycloak, so no oidc/forward-auth and no auth.groups. The three
# east-west hops below are EXPLICIT allows on top of default-deny (docs/03; R-NET-01/02);
# everything else (except DNS) is denied. Validates against schemas/servicedefinition.schema.json.
#
# Image: Overseerr (sctx/overseerr) — the Plex-native request UI on port 5055 (docs/13 row 5
# names "seerr" generically; Overseerr is the Plex-account variant). `:latest` mirrors the
# onboarding posture used for plex (image-automation off during onboarding; update.range is the
# advisory bound the ImagePolicy will enforce once the Flux image controllers are installed).
#
# No `bulk` volume: seerr keeps only its own config PVC (settings + request/cache DB) on the
# longhorn tier. It stores no media and needs no bulk mount, so OQ-2 (unresolved bulk backing)
# does not apply here.
name: seerr
kind: container
source:
  image: sctx/overseerr:latest   # Overseerr: Plex-native request UI (docs/13 row 5); served on 5055
exposure: public                 # edge port-forward + public DNS (docs/09; R-DNS/R-NET)
egress: internet                 # normal WAN egress (docs/03; R-NET-05) — TMDB/Plex.tv metadata over the internet
storage:
  - name: config
    size: 5Gi
    class: longhorn              # settings + request/cache DB: replicated app state on the 3-replica tier (docs/04; R-STATE-01/02)
dependencies:
  - to: sonarr                   # seerr -> sonarr: submit TV requests (docs/03 allow rules; docs/13 graph; R-NET-02)
    port: 8989
    protocol: tcp
  - to: radarr                   # seerr -> radarr: submit movie requests (docs/03 allow rules; docs/13 graph; R-NET-02)
    port: 7878
    protocol: tcp
  - to: plex                     # seerr -> plex: read library / watch state (docs/03 allow rules; docs/13 graph; R-NET-02)
    port: 32400
    protocol: tcp
ingressRoutes:
  - host: seerr.home.keithjackson.dev
    port: 5055                   # Overseerr web UI + API; wildcard TLS terminates at the shared Gateway (docs/08/09)
auth:
  mode: native                   # Plex account auth — documented exception, NOT Keycloak (docs/13/15; R-IDP-02)
update:
  channel: stable                # R-UPD-01 (never pre-release)
  range: ">=1.33.0"              # acceptable versions (advisory; image-automation off during onboarding)
  cadence: "0 4 * * 0"           # weekly stable check/apply
  autoRollbackOnFailedHealth: true   # R-UPD-03
observability:
  metrics: true
  slis:
    - up                         # R-OBS-01: service-down alert
backup:
  # seerr's config is on the longhorn (replicated) tier, so the L0 Kyverno backup policy
  # (servicedefinition-backup; R-STATE-03) forbids `reacquirable` here — it must reference an
  # off-cluster schedule. The request/settings DB is cheap to rebuild but still lives on the
  # irreplaceable tier, so it is backed up off-cluster like the other arr-stack config volumes.
  policy: daily-offcluster       # off-cluster backup of the longhorn config volume (docs/04; R-STATE-03)