computer-playbook/roles/categories.yml

roles:
  docker:
    title: "Docker Toolkit"
    description: "Generic Docker helpers and utilities (compose wrappers, container tooling)."
    icon: "fas fa-docker"
    invokable: false
  dev:
    title:  "Software Development Utilties"
    invokable: false
  sys:
    title: "System"
    description: "System near components. Will be automaticly called if necessary from other roles."
    invokable: false
    ctl:
      title: "Control"
      description: "Control layer for system lifecycle management—handling cleanup, monitoring, backups, alerting, maintenance, and repair tasks."
      icon: "fas fa-cogs"
      invokable: false
      cln:
        title: "Cleanup"
        description: "Roles for cleaning up various system resources—old backups, unused certificates, temporary files, Docker volumes, disk caches, deprecated domains, and more."
        icon: "fas fa-trash-alt"
        invokable: false
      hlth:
        title: "Monitoring"
        description: "Roles for system monitoring and health checks—encompassing bot-style automated checks and core low-level monitors for logs, containers, disk usage, and more."
        icon: "fas fa-chart-area"
        invokable: false
      bkp:
        title: "Backup & Restore"
        description: "Backup strategies & restore procedures"
        icon: "fas fa-hdd"
        invokable: false
      alm:
        title: "Alerting"
        description: "Notification handlers for system events"
        icon: "fas fa-bell"
        invokable: false
      mtn:
        title: "Maintenance"
        description: "Maintenance roles for certificates, system upkeep, and recurring operational tasks."
        icon: "fas fa-tools"
        invokable: false
      rpr:
        title: "Repair"
        description: "Repair and recovery roles—handling hard/soft recovery of Docker, Btrfs balancers, and other low-level system fixes."
        icon: "fas fa-wrench"
        invokable: false
    dns:
      title: "DNS Automation"
      description: "DNS providers, records, and rDNS management (Cloudflare, Hetzner, etc.)."
      icon: "fas fa-network-wired"
      invokable: false
    stk:
      title: "Stack"
      description: "Stack levels to setup the server"
      icon: "fas fa-bars-staggered"
      invokable: false
    front:
      title: "System Frontend Helpers"
      description: "Frontend helpers for reverse-proxied apps (injection, shared assets, CDN plumbing)."
      icon: "fas fa-wand-magic-sparkles"
      invokable: false
      inj:
        title: "Injection"
        description: "Composable HTML injection roles (CSS, JS, logout interceptor, analytics, desktop iframe) for Nginx/OpenResty via sub_filter/Lua with CDN-backed assets."
        icon: "fas fa-filter"
        invokable: false
  update:
    title: "Updates & Package Management"
    description: "OS & package updates"
    icon: "fas fa-sync"
    invokable: true
  drv:
    title: "Drivers"
    description: "Roles for installing and configuring hardware drivers—covering printers, graphics, input devices, and other peripheral support."
    icon: "fas fa-microchip"
    invokable: true
  gen:
    title: "Generic"
    description: "Helper roles & installers (git, locales, timer, etc.)"
    icon: "fas fa-wrench"
    invokable: true
  desk:
    title: "Desktop"
    description: "Desktop environment roles & apps (GNOME, browser, LibreOffice, etc.)"
    icon: "fas fa-desktop"
    invokable: true
  util:
    title: "Utilities"
    description: "General-purpose utility roles for both desktop and server environments—providing helper functions, customizations, and optimizations for applications, workflows, and infrastructure."
    icon: "fas fa-tools"
    invokable: false
    desk:
      title: "Desktop Utilities"
      description: "Utility roles for configuring and optimizing desktop applications and workflows—covering browsers, design tools, development environments, office suites, and gaming setups."
      icon: "fas fa-tools"
      invokable: true
    srv:
      title: "Server Utilities"
      description: "Utility roles for server-side configuration and management—covering corporate identity provisioning, network helpers, and other service-oriented toolkits."
      icon: "fas fa-cogs"
      invokable: true
    dev:
      title: "Developer Utilities"
      description: "Developer-centric server utilities and admin toolkits."
      icon: "fas fa-code"
      invokable: false
  web:
    title: "Web Infrastructure"
    description: "Roles for managing web infrastructure—covering static content services and deployable web applications."
    icon: "fas fa-globe"
    svc:
      title: "Services"
      description: "Static content servers (assets, HTML, legal, files)"
      icon: "fas fa-file"
      invokable: true
    app:
      title: "Applications"
      description: "Deployable web applications (GitLab, Nextcloud, Mastodon, etc.)"
      icon: "fas fa-docker"
      invokable: true
    opt:
      title: "Webserver Optimation"
      description: "Tools which help to optimize webservers"
      invokable: true
  svc:
    title: "Services"
    description: "Infrastructure services like databases"
    invokable: false
    db:  
      title: "Databases"
      description: "Database applications (DBMS, LDAP, Redis, etc.)"
      icon: "fas fa-database"
      invokable: true
    opt:
      title: "Service Optimation"
      description: "Optimation Services to improve your system"
      icon: "fas fa-database"
      invokable: true
    prx:
      title: "Proxy Servers"
      description: "Reverse‑proxy roles for routing and load‑balancing traffic to backend services"
      icon: "fas fa-project-diagram"
      invokable: true
    net:
      title: "Network"
      description: "Network setup (DNS, Let's Encrypt HTTP, WireGuard, etc.)"
      icon: "fas fa-globe"
      invokable: true 
    ai:
      title: "AI Services"
      description: "Core AI building blocks—model serving, OpenAI-compatible gateways, vector databases, orchestration, and chat UIs."
      icon: "fas fa-brain"
      invokable: true
    bkp:
      title: "Backup Services"
      description: "Service-level backup and recovery components—handling automated data snapshots, remote backups, synchronization services, and backup orchestration across databases, files, and containers."
      icon: "fas fa-database"
      invokable: true
  user:
    title: "Users & Access"
    description: "User accounts & access control"
    icon: "fas fa-users"
    invokable: false