# =============================================================================
# .felhom.yml - App metadata for felhom-controller
# =============================================================================

# --- Display info (shown on dashboard) ---
display_name: "BookStack"
description: "Egyszerű, könyv-szerű wiki és dokumentáció platform"
category: "productivity"
subdomain: "wiki"
slug: "bookstack"
# 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-09-22"

# --- Resource hints (displayed on deploy screen) ---
resources:
  mem_request: "150M"
  mem_limit: "512M"
  pi_compatible: true
  needs_hdd: false

# --- 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: "wiki"
    required: true
    locked_after_deploy: true
    description: "Az alkalmazás aldomainje"

  - env_var: APP_KEY
    label: "Alkalmazás kulcs"
    type: secret
    generate: "base64key:32"
    locked_after_deploy: true

  - env_var: DB_PASSWORD
    label: "Adatbázis jelszó"
    type: secret
    generate: "password:24"
    locked_after_deploy: true

  # `09` §3 decision 45: BookStack starts with admin@admin.com / password. The box replaces that password with
  # this generated one right after the install (after_install below); the app page shows it as the first password.
  - env_var: ADMIN_PASSWORD
    label: "Admin jelszó (admin@admin.com)"
    type: password
    generate: "password:24"
    description: "Az első bejelentkezéshez: admin@admin.com és ez a jelszó. Utána a profilodban módosítható."
    locked_after_deploy: true

# --- App info (info page content) ---
app_info:
  tagline: "Egyszerű wiki platform - polcok, könyvek, fejezetek és oldalak"
  default_creds: "admin@admin.com / password"
  docs_url: "https://www.bookstackapp.com/docs/"

  use_cases:
    - 'Családi tudásbázis - receptek, kézikönyvek, szabályok'
    - 'Projekt dokumentáció strukturált formában'
    - 'Könyv > Fejezet > Oldal hierarchia az áttekinthetőségért'
    - 'Teljes szöveges keresés és címkék'
    - 'WYSIWYG és Markdown szerkesztő'

  first_steps:
    - 'Nyisd meg a wiki.DOMAIN címet a böngészőben'
    - 'Jelentkezz be: admin@admin.com és a Beállítások oldalon látható első jelszó'
    - 'Változtasd meg az admin email címét a sajátodra'
    - 'Hozd létre az első polcot és könyvet'
    - 'Kezdj el írni!'


# --- After a fresh install (controller >= 0.279.0, decision 45) ---
# BookStack's OWN artisan command updates the initial admin in place. Measured on 9202 2026-09-28: afterwards
# admin@admin.com / password no longer logs in, the generated password does.
after_install:
  service: bookstack
  env: [ADMIN_PASSWORD]
  command: ["php", "/app/www/artisan", "bookstack:create-admin", "--email=admin@admin.com", "--name=Admin", "--password=${ADMIN_PASSWORD}", "--initial"]
  success: "The default admin user has been updated"

# --- Controller-side health probe ---
healthcheck:
  checks:
    - type: http
      port: 80

# --- English copy (localisation slice 5, R-560) --------------------------------------------
# The Hungarian above is UNCHANGED. A box on English reads this block field by field; a missing
# field shows the Hungarian one; a controller older than 0.257.0 ignores the block entirely.
i18n:
  en:
    description: 'A simple, book-shaped wiki and documentation platform'
    app_info:
      tagline: 'A simple wiki platform - shelves, books, chapters and pages'
      default_creds: 'admin@admin.com / password'
      use_cases:
        - 'A family knowledge base - recipes, manuals, house rules'
        - 'Project documentation with a structure you can follow'
        - 'Book > Chapter > Page, so a large set stays readable'
        - 'Full text search and tags'
        - 'A visual editor and a Markdown editor'
      first_steps:
        - 'Open wiki.DOMAIN in your browser'
        - 'Sign in: admin@admin.com and the first password shown on the settings page'
        - 'Change the admin e-mail address to your own'
        - 'Create your first shelf and book'
        - 'Start writing'
    deploy_fields:
      - env_var: DOMAIN
        label: 'Domain'
        description: 'The server domain name'
      - env_var: SUBDOMAIN
        label: 'Subdomain'
        description: 'The subdomain this app answers on'
      - env_var: DB_PASSWORD
        label: 'Database password'
      - env_var: APP_KEY
        label: 'Application key'
      - env_var: ADMIN_PASSWORD
        label: 'Admin password (admin@admin.com)'
        description: 'For the first sign-in: admin@admin.com and this password. Change it in your profile afterwards.'