admin
60f0a86bd4
gates / gates (push) Successful in 25s
The READ PATH for a second language in `.felhom.yml`. An `i18n: {en: …}` sibling
block inside the same file; `Metadata.For(lang)` merges it FIELD BY FIELD over the
Hungarian, so a missing or blank English field shows the Hungarian one and a
half-translated app is a legal, shippable state.
`For("hu")` is the parsed struct with `I18n` cleared and nothing else — measured
against all 53 real catalog files, copied into `internal/stacks/testdata/catalog/`.
Lists replace whole; every other list is matched by its own key, never by position.
`For` never writes through the receiver: the metadata is the stack manager's, shared
by concurrent requests, and an in-place merge would leak one household's language
into another household's page.
Pages reach catalog copy only through `LocalizeStacks`/`LocalizeStackPtr`/`MetaFor`,
and `TestNoDirectMetaCopyReadOnPages` keeps a named, reasoned allow-list of every
direct `.Meta.<copy>` read in `internal/web` so the NEXT page to read one fails the
suite instead of quietly rendering Hungarian to an English household.
Eight red-proofs. Two of them convicted a hollow TEST rather than the code: a struct
copy shares its slices' backing arrays, so the obvious DeepEqual mutation check
passed a deliberately broken merge; and a one-entry fixture cannot tell key matching
from position matching. Both rewritten, both then seen to fail.
MinAgent: 0.131.0 (unchanged). Older controllers are unaffected — `LoadMetadata`
uses non-strict `yaml.Unmarshal`, so a pre-0.257.0 box drops the whole block.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0159rPz1ZhFKsS53msqPYxtS
92 lines
2.9 KiB
YAML
92 lines
2.9 KiB
YAML
# =============================================================================
|
|
# .felhom.yml - App metadata for felhom-controller
|
|
# =============================================================================
|
|
|
|
# --- Display info (shown on dashboard) ---
|
|
display_name: "Plex"
|
|
description: "Népszerű média szerver csiszolt felülettel"
|
|
category: "media"
|
|
subdomain: "plex"
|
|
slug: "plex"
|
|
# catalog_since: the date THIS repo last changed this app's pinned images. Any commit that
|
|
# changes an image: line must set this to the same day (see CLAUDE.md).
|
|
catalog_since: "2026-02-15"
|
|
|
|
# --- Resource hints (displayed on deploy screen) ---
|
|
resources:
|
|
mem_request: "512M"
|
|
mem_limit: "2048M"
|
|
pi_compatible: false
|
|
needs_hdd: true
|
|
|
|
# --- Backup classification (referential coupling; see felhom.eu documentation/audits/SPIKE-backup-classification-2026-07-14.md) ---
|
|
backup:
|
|
userdata:
|
|
- path: media
|
|
class: excluded # pure reader of the shared tree (:ro); state lives in volumes
|
|
|
|
# --- Deploy fields (first deployment only) ---
|
|
deploy_fields:
|
|
- env_var: DOMAIN
|
|
label: "Domain"
|
|
type: domain
|
|
description: "A szerver domain neve"
|
|
locked_after_deploy: true
|
|
|
|
- env_var: SUBDOMAIN
|
|
label: "Aldomain"
|
|
type: subdomain
|
|
default: "plex"
|
|
required: true
|
|
locked_after_deploy: true
|
|
description: "Az alkalmazás aldomainje"
|
|
|
|
- env_var: PLEX_CLAIM
|
|
label: "Plex Claim Token"
|
|
type: text
|
|
required: true
|
|
placeholder: "claim-xxxxxxxxxxxx"
|
|
description: "Generáld a https://plex.tv/claim oldalon (4 percig érvényes)"
|
|
locked_after_deploy: true
|
|
|
|
- env_var: HDD_PATH
|
|
label: "Médiatár útvonal"
|
|
type: path
|
|
required: true
|
|
placeholder: "/mnt/felhom-drives/hdd_1"
|
|
description: "A külső merevlemez elérési útja"
|
|
locked_after_deploy: true
|
|
|
|
# --- App info (info page content) ---
|
|
app_info:
|
|
tagline: "Prémium média szerver kiváló alkalmazás támogatással"
|
|
docs_url: "https://support.plex.tv/"
|
|
|
|
use_cases:
|
|
- 'Filmek, sorozatok és zene streamelése professzionális felületen'
|
|
- 'Automatikus transzkódolás bármilyen eszközhöz'
|
|
- 'Watch Together - közös filmnézés távolról'
|
|
- 'Intro/outro skip funkció (Plex Pass)'
|
|
- 'Gazdag mobilalkalmazás és Smart TV támogatás'
|
|
|
|
first_steps:
|
|
- 'Generálj egy claim tokent a https://plex.tv/claim oldalon'
|
|
- 'Telepítés után nyisd meg a plex.DOMAIN címet'
|
|
- 'Kapcsold össze a Plex fiókoddat a szerverrel'
|
|
- 'Add hozzá a médiatárat (filmek: /media/movies, sorozatok: /media/shows)'
|
|
- 'Telepítsd a Plex alkalmazást eszközeidre'
|
|
|
|
prerequisites:
|
|
- 'Plex fiók szükséges (ingyenes regisztráció a plex.tv-n)'
|
|
- 'Külső HDD a médiafájlok tárolásához'
|
|
- 'Legalább 2 GB szabad RAM (transzkódoláshoz több ajánlott)'
|
|
|
|
# --- Controller-side health probe ---
|
|
healthcheck:
|
|
checks:
|
|
- type: api
|
|
port: 32400
|
|
path: "/identity"
|
|
expect:
|
|
status: 200
|