computer-playbook/roles/categories.yml

roles:
  cmp:
    title: "Compositions"
    description: "Composition of other roles."
    icon: "fas fa-sitemap"
    invokable: false
  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
  update:
    title: "Updates & Package Management"
    description: "OS & package updates"
    icon: "fas fa-sync"
    invokable: true
    pkgmgr:
      title: "Package Manager Helpers"
      description: "Helpers for package managers and unified install flows."
      icon: "fas fa-box-open"
      invokable: false
  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
  srv:
    title: "Server"
    description: "General server roles for provisioning and managing server infrastructure—covering web servers, proxy servers, network services, and other backend components."
    icon: "fas fa-server"
    invokable: false
    web:
      title: "Webserver"
      description: "Web-server roles for installing and configuring Nginx (core, TLS, injection filters, composer modules)."
      icon: "fas fa-server"
      invokable: false
    proxy:
      title: "Proxy Server"
      description: "Proxy-server roles for virtual-host orchestration and reverse-proxy setups."
      icon: "fas fa-project-diagram"
      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 
  user:
    title: "Users & Access"
    description: "User accounts & access control"
    icon: "fas fa-users"
    invokable: false