Refactor systemctl services and categories due to alarm bugs

This commit restructures systemctl service definitions and category mappings.

Motivation: Alarm-related bugs revealed inconsistencies in service and role handling.

Preparation step: lays the groundwork for fixing the alarm issues by aligning categories, roles, and service templates.

roles/sys-ctl-alm-email/README.md

@@ -0,0 +1,24 @@
+# Automated Email Alerts for Service Failures
+
+## Description
+
+This role installs and configures the necessary components for sending email notifications via systemd when a service fails. It sets up the `sys-ctl-alm-email` service and configures email parameters and templates using msmtp.
+
+## Overview
+
+Optimized for secure and reliable service failure notifications, this role is an integral part of the overall `sys-ctl-alm-compose` suite. It ensures that, upon failure of a critical service, an email alert is sent automatically to enable prompt troubleshooting.
+
+## Purpose
+
+The primary purpose of this role is to provide a comprehensive solution for automated email notifications in a systemd environment. By integrating with msmtp and customizable templates, it delivers clear and timely alerts about service failures, thereby enhancing system reliability.
+
+## Features
+
+- **Service Installation & Configuration:** Installs msmtp and configures the email sending service.
+- **Customizable Templates:** Supports tailoring email templates for service failure notifications.
+- **Secure Notifications:** Integrates with systemd to trigger email alerts when services fail.
+- **Suite Integration:** Part of the `sys-ctl-alm-compose` suite, offering a unified approach to service failure notifications.
+
+## Other Resources
+
+This role was created as part of a conversation with OpenAI's ChatGPT and can be found [here](https://chat.openai.com/share/96e4ca12-0888-41c0-9cfc-29c0180f0dba).

roles/sys-ctl-alm-email/handlers/main.yml

@@ -0,0 +1,4 @@
+- name: "restart sys-ctl-alm-email service"
+  systemd:
+    name: sys-ctl-alm-email{{ SYS_SERVICE_SUFFIX }}
+    daemon_reload: yes

roles/sys-ctl-alm-email/meta/main.yml

@@ -0,0 +1,23 @@
+galaxy_info:
+  author: "Kevin Veen-Birkenbach"
+  description: "Installs and configures components for sending email notifications. This role is part of the sys-ctl-alm-compose suite, providing automated alerts when services fail."
+  license: "Infinito.Nexus NonCommercial License"
+  license_url: "https://s.infinito.nexus/license"
+  company: |
+    Kevin Veen-Birkenbach
+    Consulting & Coaching Solutions
+    https://www.veen.world
+  min_ansible_version: "2.9"
+  platforms:
+  - name: Archlinux
+    versions:
+    - rolling
+  galaxy_tags:
+  - email
+  - systemd
+  - notifications
+  - automation
+  - msmtp
+  repository: "https://s.infinito.nexus/code"
+  issue_tracker_url: "https://s.infinito.nexus/issues"
+  documentation: "https://docs.infinito.nexus"

roles/sys-ctl-alm-email/tasks/01_core.yml

@@ -0,0 +1,23 @@
+- name: Include dependencies
+  include_role:
+    name: '{{ item }}'
+  loop:
+  - sys-svc-msmtp
+  - sys-rst-daemon
+
+- name: "create {{systemd_notifier_email_folder}}"
+  file:
+    path: "{{systemd_notifier_email_folder}}"
+    state: directory
+    mode: "0755"
+
+- name: configure sys-ctl-alm-email.sh
+  template:
+    src: sys-ctl-alm-email.sh.j2
+    dest: "{{systemd_notifier_email_folder}}sys-ctl-alm-email.sh"
+
+- name: configure sys-ctl-alm-email{{ SYS_SERVICE_SUFFIX }}
+  template:
+    src: sys-ctl-alm-email@.service.j2
+    dest: /etc/systemd/system/sys-ctl-alm-email.infinito@.service
+  notify: restart sys-ctl-alm-email service

roles/sys-ctl-alm-email/tasks/main.yml

@@ -0,0 +1,4 @@
+- block:
+    - include_tasks: 01_core.yml
+    - include_tasks: utils/run_once.yml
+  when: run_once_sys_ctl_alm_email is not defined

roles/sys-ctl-alm-email/templates/sys-ctl-alm-email.sh.j2

@@ -0,0 +1,15 @@
+#!/bin/bash
+
+/usr/bin/sendmail -t <<ERRMAIL
+To: {{ users.administrator.email }}
+From: systemd <{{ users['no-reply'].email }}>
+Subject: $1
+Content-Transfer-Encoding: 8bit
+Content-Type: text/plain; charset=UTF-8
+
+A problem with the service $1 occured:
+
+$(systemctl status --full "$1" | head -n 30)
+
+
+ERRMAIL

roles/sys-ctl-alm-email/templates/sys-ctl-alm-email@.service.j2

@@ -0,0 +1,8 @@
+[Unit]
+Description=status email for %i to user
+
+[Service]
+Type=oneshot
+ExecStart=/bin/bash {{systemd_notifier_email_folder}}sys-ctl-alm-email.sh %i
+User=root
+Group=systemd-journal

roles/sys-ctl-alm-email/vars/main.yml

@@ -0,0 +1 @@
+systemd_notifier_email_folder: '{{ PATH_ADMINISTRATOR_SCRIPTS }}sys-ctl-alm-email/'