Update

Author: roboes

documents/documents-tools.sh

@@ -90,6 +90,12 @@ soffice --infilter=impress_pdf_import --convert-to ppt "./input.pdf"
 # Convert .md to .docx
 pandoc "input.md" -o "output.docx"
 
+# Convert .md to .html
+pandoc "input.md" -o "input.html" \
+  -f markdown-implicit_figures \
+  --embed-resources --standalone \
+  -H <(echo '<style>body{font-family:Arial,sans-serif;max-width:700px;margin:0 auto;padding:24px 16px 60px;line-height:1.4;font-size:14px}</style>')
+
 
 # Count the number of files categorized by their root-level directory and file type
 find . -type f | while IFS= read -r file; do

technology/urlaubsverwaltung/readme.md

@@ -1074,33 +1074,48 @@ Two patterns: **employee** (both apps, standard access) and **HR admin** (full p
 **Employee** - can request leave in Urlaubsverwaltung (`USER`) and clock in/out in Zeiterfassung (`ZEITERFASSUNG_USER`):
 
 ```sh
-new_email="email@website.com"
-new_firstname="Name"
-new_lastname="Lastname"
-new_password=$(openssl rand -base64 10 | tr -dc 'A-Za-z0-9')
+# One row per employee: email|firstname|lastname
+employees=$(cat <<'EOF'
+email@website.com|Name|Lastname
+EOF
+)
 
 KEYCLOAK_TOKEN=$(curl -s \
   -d "client_id=admin-cli&grant_type=password" \
   -d "username=${keycloak_admin_user}&password=${keycloak_admin_password}" \
   http://localhost:${keycloak_http_port}/realms/master/protocol/openid-connect/token \
   | python3 -c "import sys,json; print(json.load(sys.stdin)['access_token'])")
 
-curl -s -o /dev/null -w "HTTP %{http_code}\n" \
-  -H "Authorization: Bearer ${KEYCLOAK_TOKEN}" \
-  -H "Content-Type: application/json" \
-  http://localhost:${keycloak_http_port}/admin/realms/urlaubsverwaltung/users \
-  -d "{
-    \"username\":      \"${new_email}\",
-    \"email\":         \"${new_email}\",
-    \"firstName\":     \"${new_firstname}\",
-    \"lastName\":      \"${new_lastname}\",
-    \"enabled\":       true,
-    \"emailVerified\": true,
-    \"realmRoles\":    [\"USER\", \"ZEITERFASSUNG_USER\"],
-    \"credentials\":   [{\"type\":\"password\",\"value\":\"${new_password}\",\"temporary\":true}]
-  }"
-
-echo "==> Created employee: ${new_email} / temp password: ${new_password}"
+echo "email,firstname,lastname,temp_password" > new_employees.csv
+
+while IFS='|' read -r new_email new_firstname new_lastname; do
+  [ -z "$new_email" ] && continue
+  new_password=$(openssl rand -base64 10 | tr -dc 'A-Za-z0-9')
+
+  http_code=$(curl -s -o /dev/null -w "%{http_code}" \
+    -H "Authorization: Bearer ${KEYCLOAK_TOKEN}" \
+    -H "Content-Type: application/json" \
+    http://localhost:${keycloak_http_port}/admin/realms/urlaubsverwaltung/users \
+    -d "{
+      \"username\":      \"${new_email}\",
+      \"email\":         \"${new_email}\",
+      \"firstName\":     \"${new_firstname}\",
+      \"lastName\":      \"${new_lastname}\",
+      \"enabled\":       true,
+      \"emailVerified\": true,
+      \"realmRoles\":    [\"USER\", \"ZEITERFASSUNG_USER\"],
+      \"credentials\":   [{\"type\":\"password\",\"value\":\"${new_password}\",\"temporary\":true}]
+    }")
+
+  if [ "$http_code" = "201" ]; then
+    echo "==> Created: ${new_email} / temp password: ${new_password}"
+    echo "${new_email},${new_firstname},${new_lastname},${new_password}" >> new_employees.csv
+  else
+    echo "!! FAILED (${http_code}): ${new_email}"
+  fi
+done <<< "$employees"
+
+echo "==> Done. Credentials saved to new_employees.csv"
 ```
 
 ---
@@ -1218,9 +1233,15 @@ nginx -t && systemctl reload nginx
 
 `Manage realms` → `urlaubsverwaltung` → `Realm settings` → `Themes` → Set `Login theme`.
 
+### Zeiterfassung
+
+`Persons` → HR manager → `Permissions` → Enable all permissions.
+
+`Settings` → `Festschreiben von Zeiteinträgen` → Enable `Enable time entry locking`.
+
 ### Urlaubsverwaltung
 
-Roles to HR manager: `Company` → `Staff` → Select HR manager → `Account` → `Permissions` → `Edit` → Tick: `User`, `Department Head`, `Boss`, `Office`, `Management of sick notes`, `Manage absences`.
+Roles to HR manager: `Company` → `Employees` → Select HR manager → `Account` → `Permissions` → `Edit` → Tick: `User`, `Department Head`, `Boss`, `Office`, `Management of sick notes`, `Manage absences`.
 
 Create a department and assign an approver: `Company` → `Departments` → `New department`. Set a name, then define `is department head` for specific user(s).
 
@@ -1232,14 +1253,12 @@ Create a department and assign an approver: `Company` → `Departments` → `New
 Notifications: User → `Notifications` → `E-Mail Notifications` → `Departments`:
 
 - HR manager: `Absences of my colleagues` → Enable `Submissions`, `Reminder for waiting absences to be approved`.
-- Hr manager: `Sick notes from my colleagues` → Enable `Created sick notes`, `Edited Sick Notes`.
-- User: `Sick notes from my colleagues` → Enable `Created sick notes`, `Submissions`, `Accepted Sick Notes`, `Edited Sick Notes`.
+- HR manager: `Sick notes from my colleagues` → Enable `Created sick notes`, `Submissions`, `Accepted Sick Notes`, `Edited Sick Notes`.
 
-### Zeiterfassung
+`Settings` → `Overtime`:
 
-`Persons` → HR manager → `Permissions` → Enable all permissions.
-
-`Settings` → `Festschreiben von Zeiteinträgen` → Enable `Enable time entry locking`.
+- Enable `Activate overtime management`.
+- Enable `Activate overtime transfer`.
 
 ---