From 708830fe0a11b62c9f82fa906badf84861defd1b Mon Sep 17 00:00:00 2001
From: Lars Gebhardt-Kusche <lars@kusche.berlin>
Date: Mon, 27 Jul 2026 01:36:24 +0200
Subject: [PATCH] avatar generator

---
 .projektstructure.txt                      | 2 +-
 PROJECT_CONTEXT.md                         | 1 +
 README.md                                  | 1 +
 partials/landing/account/dashboard.php     | 4 ++--
 partials/landing/community/index.php       | 4 ++--
 partials/landing/community/thread.php      | 4 ++--
 partials/structure/nav.php                 | 2 +-
 src/App/AccountPages.php                   | 6 ++++--
 src/App/{Avatar.php => Avatar/Lorelei.php} | 8 ++++----
 src/App/Community.php                      | 8 +++++---
 src/App/ProfileSettings.php                | 4 +++-
 11 files changed, 26 insertions(+), 18 deletions(-)
 rename src/App/{Avatar.php => Avatar/Lorelei.php} (97%)

diff --git a/.projektstructure.txt b/.projektstructure.txt
index d133331..78612a8 100755
--- a/.projektstructure.txt
+++ b/.projektstructure.txt
@@ -2,7 +2,7 @@ Anweisung: Projektstruktur (Basis-Template) wie in „papa-kind-treff“
 
 Aktueller Projektstand
 - Papa-Kind-Treff nutzt im Mitgliederbereich DiceBear `lorelei` über einen internen API-Proxy mit lokalem Cache.
-- Relevante Logik liegt in `src/App/Avatar.php`.
+- Relevante Logik liegt in `src/App/Avatar/Lorelei.php`.
 - Der Avatar-Proxy liegt unter `public/page/api/avatar.php`.
 - Änderungen an Funktionen mit Cookies, LocalStorage, SessionStorage, Geolocation, Tracking oder Drittanbietern müssen immer auch in Datenschutz-/Cookie-Hinweisen und im Consent-Flow berücksichtigt werden.
 
diff --git a/PROJECT_CONTEXT.md b/PROJECT_CONTEXT.md
index 60658d1..a9613e2 100644
--- a/PROJECT_CONTEXT.md
+++ b/PROJECT_CONTEXT.md
@@ -11,6 +11,7 @@ Papa-Kind-Treff ist eine PHP-basierte Plattform für Väter. Kernbereiche sind l
 - Geschäftslogik unter `src/App/`
 - MySQL/MariaDB-Schema in `schema.sql`
 - Globales Frontend vor allem über `public/assets/js/app.js` und `public/assets/css/app.css`
+- Avatar-Style `Lorelei` liegt getrennt unter `src/App/Avatar/Lorelei.php`
 
 ## Wichtige Produktentscheidungen
 - Die Ansprache im Frontend soll immer den aktuellen Nutzer direkt ansprechen.
diff --git a/README.md b/README.md
index 4e02bd7..82f1a09 100644
--- a/README.md
+++ b/README.md
@@ -37,6 +37,7 @@ Papa-Kind-Treff ist eine PHP-basierte Plattform für Väter mit Fokus auf lokale
 - `owner`
 
 Die Rechteverteilung und Community-Logik sind in `src/App/CommunityAccess.php` abgebildet.
+Die Lorelei-Avatarlogik liegt in `src/App/Avatar/Lorelei.php`.
 
 ## Consent und rechtlich relevante Integrationen
 Der aktuelle Code nutzt oder kann nutzen:
diff --git a/partials/landing/account/dashboard.php b/partials/landing/account/dashboard.php
index 6b38ffe..adff6fb 100755
--- a/partials/landing/account/dashboard.php
+++ b/partials/landing/account/dashboard.php
@@ -63,7 +63,7 @@ $sectionLinks = [
             <div class="account-panel__body">
               <div class="profile-avatar-panel">
                 <div class="profile-avatar-panel__preview">
-                  <?= \App\Avatar::render($profile, $profile['display_name'] ?: 'Papa', 'xl') ?>
+                  <?= \App\Avatar\Lorelei::render($profile, $profile['display_name'] ?: 'Papa', 'xl') ?>
                 </div>
                 <div class="profile-avatar-panel__content">
                   <h3>Dein Profilbild</h3>
@@ -300,7 +300,7 @@ $sectionLinks = [
         <div class="avatar-builder__layout">
           <div class="avatar-builder__preview">
             <div data-avatar-preview>
-              <?= \App\Avatar::render($profile, $profile['display_name'] ?: 'Papa', 'xxl') ?>
+              <?= \App\Avatar\Lorelei::render($profile, $profile['display_name'] ?: 'Papa', 'xxl') ?>
             </div>
             <p class="muted small">Wähle eine Lorelei-Variante oder lade dir direkt neue Vorschläge. Die Vorschau aktualisiert sich sofort.</p>
           </div>
diff --git a/partials/landing/community/index.php b/partials/landing/community/index.php
index dba6e51..5527a5e 100644
--- a/partials/landing/community/index.php
+++ b/partials/landing/community/index.php
@@ -115,7 +115,7 @@ $threads = $community
                 ?>
                 <article class="forum-row">
                   <div class="forum-row__topic">
-                    <div class="forum-row__avatar"><?= \App\Avatar::render($t, (string)($t['display_name'] ?: 'Mitglied'), 'forum-list') ?></div>
+                    <div class="forum-row__avatar"><?= \App\Avatar\Lorelei::render($t, (string)($t['display_name'] ?: 'Mitglied'), 'forum-list') ?></div>
                     <div>
                       <h3><a href="/community_thread?id=<?= (int)$t['id'] ?>"><?= htmlspecialchars((string)$t['title'], ENT_QUOTES) ?></a></h3>
                       <div class="forum-row__meta">
@@ -206,7 +206,7 @@ $threads = $community
             ?>
             <article class="forum-row">
               <div class="forum-row__topic">
-                <div class="forum-row__avatar"><?= \App\Avatar::render($t, (string)($t['display_name'] ?: 'Mitglied'), 'forum-list') ?></div>
+                <div class="forum-row__avatar"><?= \App\Avatar\Lorelei::render($t, (string)($t['display_name'] ?: 'Mitglied'), 'forum-list') ?></div>
                 <div>
                   <h3><a href="/community_thread?id=<?= (int)$t['id'] ?>"><?= htmlspecialchars((string)$t['title'], ENT_QUOTES) ?></a></h3>
                   <div class="forum-row__meta">
diff --git a/partials/landing/community/thread.php b/partials/landing/community/thread.php
index 1222bfe..0a65e71 100644
--- a/partials/landing/community/thread.php
+++ b/partials/landing/community/thread.php
@@ -154,7 +154,7 @@ $userVotes = ($access && $userId) ? $access->getUserPostVotes((int)$userId, $pos
 
         <article class="forum-post forum-post--lead">
           <aside class="forum-post__author">
-            <div class="forum-post__avatar"><?= \App\Avatar::render($thread, $threadAuthor, 'forum') ?></div>
+            <div class="forum-post__avatar"><?= \App\Avatar\Lorelei::render($thread, $threadAuthor, 'forum') ?></div>
             <strong><?= htmlspecialchars($threadAuthor, ENT_QUOTES) ?></strong>
             <span><?= htmlspecialchars(trim((string)($threadLevel['icon'] ?? '') . ' ' . (string)($threadLevel['label'] ?? '')), ENT_QUOTES) ?></span>
             <span><?= number_format($threadPoints, 1) ?> Punkte</span>
@@ -203,7 +203,7 @@ $userVotes = ($access && $userId) ? $access->getUserPostVotes((int)$userId, $pos
             ?>
             <article class="forum-post<?= $isHighlighted ? ' forum-post--highlighted' : '' ?>">
               <aside class="forum-post__author">
-                <div class="forum-post__avatar"><?= \App\Avatar::render($p, $postAuthor, 'forum') ?></div>
+                <div class="forum-post__avatar"><?= \App\Avatar\Lorelei::render($p, $postAuthor, 'forum') ?></div>
                 <strong><?= htmlspecialchars($postAuthor, ENT_QUOTES) ?></strong>
                 <?php if ($isHighlighted): ?>
                   <span class="forum-highlight-badge">Hilfreich hervorgehoben</span>
diff --git a/partials/structure/nav.php b/partials/structure/nav.php
index 302a2d1..c57b68f 100755
--- a/partials/structure/nav.php
+++ b/partials/structure/nav.php
@@ -48,7 +48,7 @@ if ($isLoggedIn) {
       <?php if ($isLoggedIn): ?>
         <div class="profile-menu" data-profile-menu>
           <button class="profile-menu__trigger" type="button" aria-haspopup="menu" aria-expanded="false" data-profile-menu-trigger>
-            <span class="profile-menu__avatar" aria-hidden="true"><?= \App\Avatar::render($profileRow ?? [], $displayName, 'nav') ?></span>
+            <span class="profile-menu__avatar" aria-hidden="true"><?= \App\Avatar\Lorelei::render($profileRow ?? [], $displayName, 'nav') ?></span>
             <span class="profile-menu__name"><?= htmlspecialchars($displayName, ENT_QUOTES) ?></span>
           </button>
           <div class="profile-menu__dropdown" role="menu">
diff --git a/src/App/AccountPages.php b/src/App/AccountPages.php
index 502b8e7..d4f6591 100755
--- a/src/App/AccountPages.php
+++ b/src/App/AccountPages.php
@@ -3,6 +3,8 @@ declare(strict_types=1);
 
 namespace App;
 
+use App\Avatar\Lorelei;
+
 final class AccountPages
 {
     public static function register(App $app): array
@@ -363,7 +365,7 @@ final class AccountPages
                 $profile['contact_phone'] = $crypto->decrypt((string)$profile['contact_phone']) ?: '';
             }
         }
-        $profile = array_merge($profile, Avatar::normalize($profile));
+        $profile = array_merge($profile, Lorelei::normalize($profile));
 
         $children = [];
         $stmt = $pdo?->prepare('SELECT id, encrypted_first_name AS first_name, note, gender, birthdate, age_years FROM children WHERE user_id = :id ORDER BY id DESC');
@@ -420,7 +422,7 @@ final class AccountPages
         if (!in_array($section, $allowedSections, true)) {
             $section = 'profile';
         }
-        $avatarPresetOptions = Avatar::seedChoices((string)$profile['avatar_preset']);
+        $avatarPresetOptions = Lorelei::seedChoices((string)$profile['avatar_preset']);
 
         return compact(
             'flash',
diff --git a/src/App/Avatar.php b/src/App/Avatar/Lorelei.php
similarity index 97%
rename from src/App/Avatar.php
rename to src/App/Avatar/Lorelei.php
index 132f5fe..f1516bd 100644
--- a/src/App/Avatar.php
+++ b/src/App/Avatar/Lorelei.php
@@ -1,9 +1,9 @@
 <?php
 declare(strict_types=1);
 
-namespace App;
+namespace App\Avatar;
 
-final class Avatar
+final class Lorelei
 {
     public static function defaults(): array
     {
@@ -90,7 +90,7 @@ final class Avatar
         ]];
 
         $seen = [$selectedSeed => true];
-        $base = abs((int)crc32($selectedSeed));
+        $base = abs((int) crc32($selectedSeed));
         $index = 0;
 
         while (count($choices) < $count) {
@@ -141,7 +141,7 @@ final class Avatar
         $seed = self::normalizeSeed($seed);
         $initials = strtoupper(substr(preg_replace('/[^a-z]/', '', $seed) ?: 'pk', 0, 2));
         $palette = ['#f5efe5', '#d9c7b3', '#8f6f54', '#37485a', '#c88f5b'];
-        $hash = abs((int)crc32($seed));
+        $hash = abs((int) crc32($seed));
         $bg = $palette[$hash % count($palette)];
         $fg = $hash % 2 === 0 ? '#243142' : '#ffffff';
 
diff --git a/src/App/Community.php b/src/App/Community.php
index 49c7019..ab3a995 100755
--- a/src/App/Community.php
+++ b/src/App/Community.php
@@ -3,6 +3,8 @@ declare(strict_types=1);
 
 namespace App;
 
+use App\Avatar\Lorelei;
+
 final class Community
 {
     private ?array $forumStructure = null;
@@ -151,7 +153,7 @@ final class Community
         $where = $conditions ? ('AND ' . implode(' AND ', $conditions)) : '';
 
         $avatarSelect = $this->hasColumn('user_profiles', 'avatar_outfit_color')
-            ? ', ' . Avatar::selectColumns('p')
+            ? ', ' . Lorelei::selectColumns('p')
             : '';
         $sql = "SELECT ft.id, ft.title, ft.body, ft.created_at, ft.updated_at,
                        u.id as uid, u.created_at as user_created,
@@ -207,7 +209,7 @@ final class Community
     {
         $select = 'ft.*, p.display_name';
         if ($this->hasColumn('user_profiles', 'avatar_outfit_color')) {
-            $select .= ', ' . Avatar::selectColumns('p');
+            $select .= ', ' . Lorelei::selectColumns('p');
         }
         $join = '';
         if ($this->hasColumn('forum_threads', 'board_id') && $this->hasTable('forum_boards') && $this->hasTable('forum_categories')) {
@@ -227,7 +229,7 @@ final class Community
     {
         $select = 'fp.*, p.display_name';
         if ($this->hasColumn('user_profiles', 'avatar_outfit_color')) {
-            $select .= ', ' . Avatar::selectColumns('p');
+            $select .= ', ' . Lorelei::selectColumns('p');
         }
         if ($this->hasColumn('forum_posts', 'highlighted_at')) {
             $select .= ', hp.display_name AS highlighted_by_name';
diff --git a/src/App/ProfileSettings.php b/src/App/ProfileSettings.php
index bea7dbc..b77846c 100644
--- a/src/App/ProfileSettings.php
+++ b/src/App/ProfileSettings.php
@@ -3,6 +3,8 @@ declare(strict_types=1);
 
 namespace App;
 
+use App\Avatar\Lorelei;
+
 final class ProfileSettings
 {
     private bool $schemaEnsured = false;
@@ -87,7 +89,7 @@ final class ProfileSettings
         }
 
         $this->ensureSchema();
-        $avatar = Avatar::normalize($avatarConfig);
+        $avatar = Lorelei::normalize($avatarConfig);
         $stmt = $this->pdo->prepare(
             'UPDATE user_profiles
              SET avatar_preset = :preset,