mkdocs.yml

site_name: Kamerplanter Dokumentation
site_url: https://nolte.github.io/kamerplanter/
site_description: Dokumentation für die Kamerplanter Pflanzenpflege-Plattform — von der Aussaat bis zur Ernte.
site_author: Kamerplanter Development Team

repo_url: https://github.com/nolte/kamerplanter
repo_name: nolte/kamerplanter
edit_uri: edit/develop/docs/

copyright: Copyright © 2026 Kamerplanter

docs_dir: docs

# Fact-table partials generated by scripts/docs/gen_fact_tables.py are pulled
# into pages via pymdownx.snippets (which reads them straight from disk). They
# must not become standalone pages, so exclude the folder from page collection.
exclude_docs: |
  _generated/

theme:
  name: material
  language: de

  palette:
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: green
      accent: light green
      toggle:
        icon: material/brightness-7
        name: Zum Dunkelmodus wechseln
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: green
      accent: light green
      toggle:
        icon: material/brightness-4
        name: Zum Hellmodus wechseln

  font:
    text: Roboto
    code: Roboto Mono

  logo: assets/images/logo.svg
  favicon: assets/images/favicon.png

  features:
    - navigation.tracking
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.sections
    - navigation.expand
    - navigation.path
    - navigation.indexes
    - navigation.top
    - search.suggest
    - search.highlight
    - search.share
    - header.autohide
    - toc.follow
    - content.code.copy
    - content.code.annotate
    - content.tabs.link
    - content.action.edit
    - content.action.view

extra_css:
  - stylesheets/extra.css

extra_javascript:
  - javascripts/extra.js

plugins:
  - search:
      lang:
        - de
        - en
      separator: '[\s\-,:!=\[\]()\"/]+|(?!\b)(?=[A-Z][a-z])|\.(?!\d)|&[lg]t;'

  - i18n:
      docs_structure: folder
      languages:
        - locale: de
          name: Deutsch
          default: true
          build: true
        - locale: en
          name: English
          build: true
          nav_translations:
            Startseite: Home
            Stammdaten-Import: Master Data Import
            Konto & Anmeldung: Account & Sign-In
            Benachrichtigungen: Notifications
            Externe Datenanreicherung: External Data Enrichment
            Erste Schritte: Getting Started
            Deine erste Pflanze: Your First Plant
            Funktionen entdecken: Discover Features
            Docker installieren: Docker Installation
            Docker Compose Schnellstart: Docker Compose Quick Start
            Docker Compose Dauerbetrieb: Docker Compose Permanent Operation
            Benutzerhandbuch: User Guide
            Stammdaten: Plant Master Data
            Standorte & Substrate: Locations & Substrates
            Wachstumsphasen: Growth Phases
            Dünge-Logik: Fertilization Logic
            Sensorik: Sensors
            Wetterquellen: Weather Sources
            Berechnungen: Calculations
            Aufgaben: Tasks
            Ernte: Harvest
            Nacherntebehandlung: Post-Harvest
            Pflanzenschutz (IPM): Pest Management (IPM)
            Pflanzdurchläufe: Planting Runs
            Tankmanagement: Tank Management
            Betriebsmittel & Inventar (InvenTree): Equipment & Inventory (InvenTree)
            Aquaponik: Aquaponics
            Kalender: Calendar
            Dashboard: Dashboard
            Dashboard personalisieren: Personalizing Your Dashboard
            Onboarding-Wizard: Onboarding Wizard
            Light-Modus: Light Mode
            Kiosk-Modus: Kiosk Mode
            KI-Assistent: AI Assistant
            KI-Diagnose: AI Diagnosis
            KI-Provider einrichten: AI Provider Setup
            Fachbegriff-Glossar: Terminology Glossary
            Umgebungssteuerung: Actuator Control
            Mandanten & Gaerten: Tenants & Gardens
            Pflegeerinnerungen: Care Reminders
            Saison-Automatik: Season Automation
            Überwinterung: Overwintering
            Module & Funktionen: Modules & Features
            Vermehrung: Propagation
            Datenschutz (DSGVO): Privacy (GDPR)
            Druckansichten & Export: Print & Export
            Schädlinge per Foto erkennen: Pest Detection by Photo
            Schädlings-Detailseite: Pest Detail Page
            Behandlungs-Detailseite: Treatment Detail Page
            Pflanze per Foto identifizieren: Identify Plant by Photo
            Referenzbilder kuratieren: Curate Reference Images
            Pflanzenfoto-Galerie: Plant Photo Gallery
            Gießprotokoll: Watering Log
            Plattform-Admin: Platform Admin
            Speicher konfigurieren: Configure Storage
            Wetterdienste konfigurieren: Configuring Weather Services
            Architektur: Architecture
            Überblick: Overview
            Backend: Backend
            Frontend: Frontend
            Datenbank: Database
            Infrastruktur: Infrastructure
            KI-Architektur: AI Architecture
            Entwicklung: Development
            Lokales Setup: Local Setup
            Code-Standards: Code Standards
            Testen: Testing
            Debugging: Debugging
            MCP-Werkzeuge: MCP Tools
            Workflows: Workflows
            API: API
            Authentifizierung: Authentication
            Fehlerbehandlung: Error Handling
            Betriebsprofile: Deployment Profiles
            Konfigurationsmatrix: Configuration Matrix
            Deployment: Deployment
            Kubernetes: Kubernetes
            Helm Charts: Helm Charts
            ArgoCD: ArgoCD
            CI/CD: CI/CD
            Bilderkennung (Inferenz-Service): Setting Up Plant Identification
            Guides: Guides
            GDD-Berechnung: GDD Calculation
            VPD-Optimierung: VPD Optimization
            Nährlösung mischen: Nutrient Mixing
            Betriebs-Fehlerbehebung: Operations Troubleshooting
            Pflanzendaten per AI: AI Plant Data Pipeline
            Home Assistant Integration: Home Assistant Integration
            Klimazonen & Winterhärte: Climate Zones & Hardiness
            Browser-Push einrichten: Set Up Browser Push
            RAG-Wissensbasis: RAG Knowledge Base
            Service Accounts: Service Accounts
            MCP-Server: MCP Server
            Datenaufbewahrung: Data Retention
            Mischkultur: Companion Planting
            Nachernte: Post-Harvest
            'Journey: Cannabis-Grow-Zyklus': 'Journey: Cannabis Grow Cycle'
            'Journey: Das Freiland-Gartenjahr': 'Journey: The Outdoor Garden Year'
            'Journey: Hydroponik-Setup (NFT & DWC)': 'Journey: Hydroponics Setup (NFT & DWC)'
            CanG-Compliance für Anbauvereinigungen: CanG Compliance for Cultivation Associations
            Pflanzenprobleme lösen: Plant Health Troubleshooting
            Glossar: Glossary
            Referenz: Reference
            API-Referenz: API Reference
            Datenbankschema: Database Schema
            Umgebungsvariablen: Environment Variables
            ADR: ADR
            Changelog: Changelog
            Unveröffentlicht: Unreleased
            Claude Skills: Claude Skills
            Claude Agents: Claude Agents
            Claude Tags: Claude Tags

  - literate-nav:
      nav_file: SUMMARY.md

  - git-revision-date-localized:
      enable_creation_date: true
      type: timeago
      fallback_to_build_date: true
      strict: false

  - awesome-pages:
      collapse_single_pages: false

  - minify:
      minify_html: true
      minify_js: false
      minify_css: true
      htmlmin_opts:
        remove_comments: true

  - redirects:
      redirect_maps:
        de/getting-started/installation.md: de/deployment/docker-installation.md
        de/getting-started/quickstart.md: de/deployment/docker-quickstart.md
        de/getting-started/first-deployment.md: de/deployment/docker-dauerbetrieb.md
        en/getting-started/installation.md: en/deployment/docker-installation.md
        en/getting-started/quickstart.md: en/deployment/docker-quickstart.md
        en/getting-started/first-deployment.md: en/deployment/docker-dauerbetrieb.md
        de/guides/troubleshooting.md: de/development/troubleshooting.md
        en/guides/troubleshooting.md: en/development/troubleshooting.md

markdown_extensions:
  - abbr
  - admonition
  - attr_list
  - def_list
  - footnotes
  - md_in_html
  - tables
  - toc:
      permalink: true
      toc_depth: 3
  - pymdownx.betterem:
      smart_enable: all
  - pymdownx.caret
  - pymdownx.details
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.keys
  - pymdownx.mark
  - pymdownx.smartsymbols
  - pymdownx.snippets:
      auto_append:
        - includes/abbreviations.md
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.tasklist:
      custom_checkbox: true
  - pymdownx.tilde

extra:
  version:
    provider: mike
    default: stable
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/nolte/kamerplanter

nav:
  - Startseite: de/index.md
  - Erste Schritte:
      - de/getting-started/index.md
      - Deine erste Pflanze: de/getting-started/erste-pflanze.md
      - Funktionen entdecken: de/getting-started/funktionen-entdecken.md
  - Benutzerhandbuch:
      - de/user-guide/index.md
      - Stammdaten: de/user-guide/plant-management.md
      - Stammdaten-Import: de/user-guide/import.md
      - Standorte & Substrate: de/user-guide/locations-substrates.md
      - Wachstumsphasen: de/user-guide/growth-phases.md
      - Vermehrung: de/user-guide/propagation.md
      - Dünge-Logik: de/user-guide/fertilization.md
      - Gießprotokoll: de/user-guide/watering-log.md
      - Sensorik: de/user-guide/sensors.md
      - Wetterquellen: de/user-guide/weather-sources.md
      - Berechnungen: de/user-guide/calculations.md
      - Aufgaben: de/user-guide/tasks.md
      - Ernte: de/user-guide/harvest.md
      - Nacherntebehandlung: de/user-guide/post-harvest.md
      - Pflanzenschutz (IPM): de/user-guide/pest-management.md
      - Pflanzenprobleme lösen: de/user-guide/plant-health-troubleshooting.md
      - KI-Diagnose: de/user-guide/ai-diagnosis.md
      - Pflanzdurchläufe: de/user-guide/planting-runs.md
      - Tankmanagement: de/user-guide/tanks.md
      - Betriebsmittel & Inventar (InvenTree): de/user-guide/inventree.md
      - Aquaponik: de/user-guide/aquaponics.md
      - Kalender: de/user-guide/calendar.md
      - Dashboard: de/user-guide/dashboard.md
      - Dashboard personalisieren: de/user-guide/dashboard-personalization.md
      - Onboarding-Wizard: de/user-guide/onboarding.md
      - Konto & Anmeldung: de/user-guide/account.md
      - Module & Funktionen: de/user-guide/module-visibility.md
      - Light-Modus: de/user-guide/light-mode.md
      - Kiosk-Modus: de/user-guide/kiosk-mode.md
      - KI-Assistent: de/user-guide/ai-assistant.md
      - KI-Provider einrichten: de/user-guide/ai-providers.md
      - Fachbegriff-Glossar: de/user-guide/glossary.md
      - Umgebungssteuerung: de/user-guide/actuator-control.md
      - Mandanten & Gaerten: de/user-guide/tenants.md
      - Pflegeerinnerungen: de/user-guide/care-reminders.md
      - Saison-Automatik: de/user-guide/season-automation.md
      - Überwinterung: de/user-guide/overwintering.md
      - Benachrichtigungen: de/user-guide/notifications.md
      - Datenschutz (DSGVO): de/user-guide/privacy.md
      - Druckansichten & Export: de/user-guide/print-export.md
      - Schädlinge per Foto erkennen: de/user-guide/pest-detection.md
      - Schädlings-Detailseite: de/user-guide/pest-detail.md
      - Behandlungs-Detailseite: de/user-guide/treatment-detail.md
      - Pflanze per Foto identifizieren: de/user-guide/plant-identification.md
      - Referenzbilder kuratieren: de/user-guide/reference-image-curation.md
      - Pflanzenfoto-Galerie: de/user-guide/plant-photos.md
      - Plattform-Admin: de/user-guide/admin.md
      - Speicher konfigurieren: de/user-guide/object-storage.md
      - Wetterdienste konfigurieren: de/user-guide/weather-services.md
  - Architektur:
      - de/architecture/index.md
      - Überblick: de/architecture/overview.md
      - Backend: de/architecture/backend.md
      - Frontend: de/architecture/frontend.md
      - Datenbank: de/architecture/database.md
      - Infrastruktur: de/architecture/infrastructure.md
      - KI-Architektur: de/architecture/ai-architecture.md
  - Entwicklung:
      - de/development/index.md
      - Lokales Setup: de/development/local-setup.md
      - Code-Standards: de/development/code-standards.md
      - Testen: de/development/testing.md
      - Debugging: de/development/debugging.md
      - MCP-Werkzeuge: de/development/mcp-tools.md
      - Workflows: de/development/workflows.md
      - Betriebs-Fehlerbehebung: de/development/troubleshooting.md
      - API:
          - de/api/index.md
          - Überblick: de/api/overview.md
          - Authentifizierung: de/api/authentication.md
          - Fehlerbehandlung: de/api/error-handling.md
          - Service Accounts: de/api/service-accounts.md
          - MCP-Server: de/api/mcp-server.md
  - Deployment:
      - de/deployment/index.md
      - Docker installieren: de/deployment/docker-installation.md
      - Docker Compose Schnellstart: de/deployment/docker-quickstart.md
      - Docker Compose Dauerbetrieb: de/deployment/docker-dauerbetrieb.md
      - Betriebsprofile: de/deployment/betriebsprofile.md
      - Konfigurationsmatrix: de/deployment/konfigurationsmatrix.md
      - Kubernetes: de/deployment/kubernetes.md
      - Helm Charts: de/deployment/helm.md
      - ArgoCD: de/deployment/argocd.md
      - CI/CD: de/deployment/ci-cd.md
      - Bilderkennung (Inferenz-Service): de/deployment/inference-service.md
  - Guides:
      - de/guides/index.md
      - 'Journey: Cannabis-Grow-Zyklus': de/guides/journey-cannabis-cycle.md
      - 'Journey: Das Freiland-Gartenjahr': de/guides/journey-garden-year.md
      - 'Journey: Hydroponik-Setup (NFT & DWC)': de/guides/journey-hydroponics-setup.md
      - CanG-Compliance für Anbauvereinigungen: de/guides/compliance-anbauvereinigung.md
      - GDD-Berechnung: de/guides/gdd-calculation.md
      - VPD-Optimierung: de/guides/vpd-optimization.md
      - Klimazonen & Winterhärte: de/guides/climate-zones.md
      - Mischkultur: de/guides/companion-planting.md
      - Nährlösung mischen: de/guides/nutrient-mixing.md
      - Nachernte: de/guides/post-harvest.md
      - RAG-Wissensbasis: de/guides/rag-knowledge-base.md
      - Pflanzendaten per AI: de/guides/ai-plant-data-pipeline.md
      - Externe Datenanreicherung: de/guides/data-enrichment.md
      - Home Assistant Integration: de/guides/home-assistant-integration.md
      - Browser-Push einrichten: de/guides/browser-push-setup.md
      - Datenaufbewahrung: de/guides/data-retention.md
  - Referenz:
      - de/reference/index.md
      - Glossar: de/reference/glossary.md
      - API-Referenz: de/reference/api-reference.md
      - Datenbankschema: de/reference/database-schema.md
      - Umgebungsvariablen: de/reference/environment-variables.md
      - ADR:
          - de/adr/index.md
      - Changelog:
          - de/changelog/index.md
          - Unveröffentlicht: de/changelog/unreleased.md
      - Claude Code:
          - Claude Skills: de/skills/
          - Claude Agents: de/agents/
          - Claude Tags: de/tags.md