Files
felhom-controller/controller/internal/stacks/testdata/catalog/homebox/.felhom.yml
T
admin 60f0a86bd4
gates / gates (push) Successful in 25s
v0.257.0: the app catalog can speak English (R-560, slice 5 Part A)
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
2026-09-20 14:31:52 +02:00

79 lines
2.5 KiB
YAML

# =============================================================================
# .felhom.yml — App metadata for felhom-controller
# =============================================================================
# Place alongside docker-compose.yml in each stack directory:
# /opt/docker/stacks/homebox/.felhom.yml
# =============================================================================
# --- Display info (shown on dashboard) ---
display_name: "Homebox"
description: "Otthoni leltár és eszköznyilvántartás"
category: "tools"
subdomain: "inventory"
# --- Asset slug ---
slug: "homebox"
# 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-07-19"
# --- Resource hints (displayed on deploy screen) ---
resources:
mem_request: "50M"
mem_limit: "256M"
pi_compatible: true
needs_hdd: false
# --- Deploy fields ---
deploy_fields:
- env_var: DOMAIN
label: "Domain"
type: domain
description: "A szerver domain neve"
locked_after_deploy: true
- env_var: HBOX_AUTH_API_KEY_PEPPER
label: "API-kulcs pepper"
type: secret
generate: "base64key:48"
locked_after_deploy: true
# A Homebox 0.26+ pánikol induláskor, ha ez nincs beállítva (min. 32 bájt).
# Ez sózza az API-kulcsokat: ha újragenerálódik, MINDEN kiadott API-kulcs
# érvénytelenné válik, ezért visszaállításkor a régi értéket kell megtartani.
data_key: true
- env_var: SUBDOMAIN
label: "Aldomain"
type: subdomain
default: "inventory"
required: true
locked_after_deploy: true
description: "Az alkalmazás aldomainje"
# --- App info (info page content) ---
app_info:
tagline: 'Otthoni leltár kezelő - tartsd számon a tárgyaidat'
docs_url: 'https://homebox.software/en/'
use_cases:
- 'Otthoni tárgyak leltározása és nyilvántartása'
- 'Helyszínek, címkék és kategóriák szerinti rendszerezés'
- 'Garancia lejáratok és beszerzési árak nyilvántartása'
- 'Vonalkód szkennelés a gyors hozzáadáshoz'
- 'Biztosítási célú leltár készítés'
first_steps:
- 'Nyisd meg az inventory.DOMAIN címet a böngészőben'
- 'Hozd létre a fiókodat az első megnyitáskor'
- 'Add hozzá a helyszíneket (pl. nappali, konyha, garázs)'
- 'Kezdd el felvenni a tárgyakat fotókkal'
# --- Controller-side health probe ---
healthcheck:
checks:
- type: api
port: 7745
path: "/api/v1/status"
expect:
status: 200